frontend-dev/README.md

Smaage Frontend Prototype

TODO

• switch save and cancel -> in case save and not abort
• make recipes available through menu
• remove calibration tools button in mock

Install Requirements

uv sync

Run

uv run -m frontend

Navigation

• L: left press
• LL: left long press
• R: right press
• RL: right long press
• LB: long left and right press

stateDiagram-v2
    [*] --> Main

    state "Main View<br>(timer + weight)" as Main
    state "Menu<br>(carousel)" as Menu
    state "Bluetooth Pairing<br>(waiting for connection)" as BTPairing
    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 --> Menu : LB
    Main --> RecipeSelection : RL

    Menu --> Main : LL [back]
    Menu --> BTPairing : RL [BT Pair]
    Menu --> RecipeSelection : RL [Recipes]

    BTPairing --> Menu : LL [cancel]

    RecipeSelection --> Main : LL
    RecipeSelection --> DoRecipe : RL [on recipe → run]
    RecipeSelection --> EditRecipe : LB [on recipe → edit]<br>or RL [on + → add]

    DoRecipe --> Main : LL [back]<br>or R [last step → done]

    EditRecipe --> RecipeSelection : LL [back]<br>or RL [on save]
    EditRecipe --> TypeSelect : RL [on step]<br>or RL [on + → add step]
    EditRecipe --> ValueEntry : RL [on name]
    EditRecipe --> MoveMode : LB [on step]

    MoveMode --> EditRecipe : LB [confirm]<br>or LL [cancel]

    TypeSelect --> ValueEntry : RL [type with value]
    TypeSelect --> EditRecipe : RL [type w/o value → saved]<br>or RL [delete → deleted]<br>or LL [back]

    ValueEntry --> EditRecipe : LL [save]<br>or L [cancel]
    ValueEntry --> GoalTime : LL [WEIGH_WITH_TIMER]

    GoalTime --> EditRecipe : LL [save]<br>or L [cancel]

Tools

export_loading_frames.py

Renders the loading screen animation and exports every unique frame as both PNG files and a NumPy array.

Usage

uv run export_loading_frames.py [--out-dir <directory>]

Argument	Default	Description
--out-dir	frames/	Directory to write output files into

Outputs

File	Description
frames/frame_XXXX.png	One PNG per unique frame, zero-padded index
frames/frames.npy	NumPy array of shape (N, H, W), dtype bool

Consecutive duplicate frames are collapsed so only visually distinct frames are exported. The script prints the total number of frames rendered and the number of unique frames kept.