frontend-dev/README.md

Smaage Frontend Prototype

Install Requirements

uv sync

Run

uv run -m frontend

Navigation

stateDiagram-v2
    [*] --> Main

    state "Main View<br>(timer + weight)" as Main
    state "Recipe Selection<br>(carousel)" as RecipeSelection
    state "Do Recipe<br>(step-by-step)" as DoRecipe
    state "Edit Recipe<br>(step list)" as EditRecipe
    state "Edit Recipe – Move Mode<br>(reorder steps)" as MoveMode
    state "Edit Step – Type Selection<br>(list view)" as TypeSelect
    state "Edit Step – Value Entry<br>(morse input)" as ValueEntry
    state "Edit Step – Goal Time Entry<br>(morse input)" as GoalTime

    Main --> RecipeSelection : right long press

    RecipeSelection --> Main : left long press
    RecipeSelection --> DoRecipe : right long press [on recipe → run]
    RecipeSelection --> EditRecipe : both long press [on recipe → edit]<br>or right long press [on + → add]

    DoRecipe --> Main : left long press [back]<br>or right press [last step → done]

    EditRecipe --> RecipeSelection : left long press [back]<br>or right long press [on save]
    EditRecipe --> TypeSelect : right long press [on step]<br>or right long press [on + → add step]
    EditRecipe --> ValueEntry : right long press [on name]
    EditRecipe --> MoveMode : both long press [on step]

    MoveMode --> EditRecipe : both long press [confirm]<br>or left long press [cancel]

    TypeSelect --> ValueEntry : right long press [type with value]
    TypeSelect --> EditRecipe : right long press [type w/o value → saved]<br>or right long press [delete → deleted]<br>or left long press [back]

    ValueEntry --> EditRecipe : left long press [save]<br>or left press [cancel]
    ValueEntry --> GoalTime : left long press [WEIGH_WITH_TIMER]

    GoalTime --> EditRecipe : left long press [save]<br>or left press [cancel]