🍳 Development Process Documentation

Recipe Scaler - A One-Shot AI Build

✨ One-Shot Build

Project Overview

This recipe scaler was built as a one-shot project - conceived, designed, and implemented in a single pass using AI-assisted development. The goal: create a practical tool that solves the universal problem of scaling recipes up or down without doing mental math while hungry.

1
Development Pass
~400
Lines of Code
100%
Client-Side
0
Dependencies

The "One-Shot" Philosophy

Unlike the previous Good Vibes Only projects which used iterative feedback cycles, this project was built in a single creative burst. The AI agent was given:

Why One-Shot?

Sometimes the best approach is to trust the AI's judgment and let it run. The recipe scaler is a well-understood problem space with clear inputs and outputs. No API integration, no backend, no complex business logic - just pure frontend fun.

This approach works best when:

  • The problem domain is well-defined
  • No external dependencies or APIs
  • The feature set is bounded and clear
  • It's a tool you've used before (so you know what's important)

AI Agent Used

Built using Claude Opus 4.5 via Clawdbot, an AI gateway that manages conversations across Discord, Telegram, and other platforms. The agent (named "Shelldon" 🦀) handled the entire build from brainstorm to deployment.

Technical Architecture

Frontend: HTML5, CSS3, Vanilla JS
Parsing: Regex-based ingredient parser
Math: Fraction handling, smart rounding
UX: Copy to clipboard, example recipes

Key Features Implemented

Smart Ingredient Parsing
Handles multiple formats: whole numbers (2), decimals (0.5), fractions (1/2), mixed numbers (1 1/2), and Unicode fractions (½). Extracts amounts, units, and ingredient names.
Extensive Unit Support
Recognizes cups, tablespoons, teaspoons, ounces, pounds, grams, kilograms, milliliters, liters, plus culinary units like pinch, dash, clove, can, bunch, head, and stick.
Sensible Rounding
Converts ugly decimals to nice fractions (0.667 → ⅔). Nobody needs "2.857 tbsp" of anything. Shows original amount for reference.
Copy to Clipboard
One-click export of scaled ingredients. Visual feedback confirms the copy worked.
Example Recipe Loader
Demo button loads a sample recipe so users can immediately see how scaling works.

Parsing Challenges

The Regex Gauntlet

Ingredient parsing is surprisingly tricky. The parser handles:

2 cups flour → amount: 2, unit: cup 1/2 tsp salt → amount: 0.5, unit: teaspoon 1 1/2 cups sugar → amount: 1.5, unit: cup 3/4 cup butter, softened → amount: 0.75, unit: cup 2 large eggs → amount: 2, unit: large pinch of cinnamon → not scalable (no amount) salt to taste → not scalable

Design Decisions

What Could Be Added (Future Ideas)

Potential Enhancements

Unit Conversion Mode: Convert between metric and imperial (cups ↔ grams for flour)
Smart Substitutions: "You have 3 eggs but need 4? Here's how to substitute..."
Recipe URL Import: Paste a link, auto-extract ingredients from recipe sites
Save Favorites: LocalStorage for frequently scaled recipes
Pan Size Calculator: Scale based on pan dimensions, not just servings
Print Stylesheet: Clean printable output for kitchen use

The Brainstorm Process

This project emerged from a brainstorming session that generated 8 potential ideas:

  1. Recipe Scaler ← Selected!
  2. Photo Wall Planner
  3. Practice Timer (for instrument practice)
  4. Moving Box Inventory
  5. Plant Watering Tracker
  6. "What Should We Watch" Randomizer
  7. Allowance Tracker
  8. Family Command Center

The Recipe Scaler won because it's universally useful, has a contained scope, and scratches a real itch that everyone who cooks has experienced.

Process Documentation

Open Graph Image

The OG image for social sharing was generated using Google Gemini 2.0 Flash with a prompt describing a warm, kitchen-themed visualization of recipe scaling.

Key Takeaways

Final Thoughts

The Recipe Scaler demonstrates that not every project needs weeks of planning and dozens of feedback cycles. Sometimes you just need to identify a clear problem, point an AI at it, and get out of the way.

Total time from "let's do the recipe scaler" to deployed application: under 10 minutes. That's the power of AI-assisted development when the problem space is well-understood.

Now go scale some recipes. You're welcome. 🍳

← Back to Recipe Scaler