Skip to content

Baked-Metric is a precision-focused kitchen utility designed to bridge the gap between culinary intuition and scientific accuracy by accounting for the fundamental physics of baking.

License

Notifications You must be signed in to change notification settings

dovvnloading/Baked-Metric

Repository files navigation

License Build Status React TypeScript Vite Tailwind

Baked-Metric

Baked-Metric Application Interface

Kitchen Chemistry

Baking is not an art; it is chemistry. While generic conversion tools treat every ingredient like water, Baked-Metric respects the physics of the kitchen.

Most recipes fail not because of technique, but because of imprecise translation. A cup of flour weighs significantly less than a cup of sugar, and 350°F behaves differently at sea level than it does in Denver. This application bridges the gap between recipe intent and environmental reality.

Built with a soft-UI design system, it feels as natural and tactile as the ingredients themselves.

Core Utilities

1. Density-Aware Conversion

Standard volume-to-weight converters are often inaccurate because they ignore specific gravity. Baked-Metric utilizes a database of over 50 specific ingredient densities.

  • Context: 1 Cup of All-Purpose Flour (≈125g) ≠ 1 Cup of Sugar (≈200g).
  • Solution: Select specific ingredients to derive exact gram weights from volumetric measurements.

2. High-Altitude Thermodynamics

Air pressure drops as elevation rises, causing water to boil at lower temperatures and leavening gases to expand more rapidly.

  • Context: Baking a cake at 5,000ft using sea-level instructions often results in structural collapse.
  • Solution: An integrated slider calculates the necessary oven temperature offsets and gas mark adjustments based on your current elevation.

3. Pan Geometry Scaling

Changing bakeware requires more than guesswork. A recipe designed for a 9-inch round pan cannot simply be poured into an 8-inch square pan without altering the bake time or depth.

  • Context: Surface area dictates evaporation rates and heat distribution.
  • Solution: Mathematically compares the surface area (or volume for Bundts) of source and target pans to generate a precise scaling ratio (e.g., "Multiply all ingredients by 1.23x").

Technical Architecture

This project serves as a modern reference implementation for React 19 and strict TypeScript integration. It demonstrates how to build complex, state-driven interfaces without relying on heavy UI component libraries.

  • Framework: React 19 (Hooks, Functional Components)
  • Language: TypeScript (Strict Mode)
  • Build Tool: Vite
  • Styling: TailwindCSS with a custom Neumorphic/Claymorphic design system
  • Deployment: GitHub Actions (CI/CD) to GitHub Pages

Local Development

This project uses standard Node.js tooling. Ensure you have Node.js (v18+) installed.

  1. Clone the repository

    git clone https://github.com/dovvnloading/Baked-Metric.git
    cd Baked-Metric
  2. Install dependencies

    npm install
  3. Start the development server

    npm run dev
  4. Build for production

    npm run build

License

This project is open-source and available under the MIT License. You are free to copy, modify, and distribute this software for educational or commercial purposes.

About

Baked-Metric is a precision-focused kitchen utility designed to bridge the gap between culinary intuition and scientific accuracy by accounting for the fundamental physics of baking.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors