#Notes

• Frontend: Rabbita (Elm-architecture UI framework, compiles to JS)
• Backend: Mocket (HTTP server, compiles to native) + SQLite3 (persistence)
• Shared: Common types, routes, validation, and statistics logic compiled for both targets

#Quick Start

moon update
make serve

#Features

• Create notes with title and content
• Pin/unpin important notes (pinned notes appear first)
• Note statistics: word count, character count, estimated reading time
• Note list with content preview and word count badges
• Delete notes
• Input validation (title: 1-100 chars, content: 1-5000 chars)
• Data persists in SQLite (notes.db)
• Single codebase, two compilation targets (js for frontend, native for backend)

#Isomorphic Design

#What is shared

• Note and NoteStats types (types.mbt) — structs with derive(ToJson, FromJson). The backend constructs Note values from SQLite rows and serializes them. The frontend deserializes the same JSON into the same type.

• Route paths (routes.mbt) — API paths defined once. The frontend calls @shared.api_note_pin(id) to build request URLs. The backend uses @shared.api_notes for route registration.

• Validation (validation.mbt) — validate_title() and validate_content() enforce length limits. Same rules, one definition, enforced on both sides.

• Statistics and sorting (logic.mbt) — compute_stats() calculates word count, character count, and reading time. truncate_preview() generates content previews. sort_notes() orders pinned notes first. The same logic runs on both targets.

#API

#Project Structure

shared/              # Isomorphic code (both js and native)
  types.mbt          #   Note and NoteStats structs with ToJson/FromJson
  routes.mbt         #   API path constants and builders
  validation.mbt     #   Title and content length validation
  logic.mbt          #   Statistics, preview truncation, sorting
backend/main.mbt     # Mocket HTTP server + SQLite3 CRUD
frontend/main.mbt    # Rabbita MVU app (model, update, view)
public/              # Build output for frontend JS
moon.mod.json        # Module config and dependencies
Makefile             # Build and run commands

#Architecture

#System Architecture

graph LR
    Browser["Browser"]
    Frontend["Frontend (JS)<br/>main.mbt<br/>app/{types,update,view,styles}.mbt"]
    API["REST API"]
    Backend["Backend (Native)<br/>main.mbt, db.mbt"]
    DB["SQLite<br/>notes.db"]
    Shared["Shared Code<br/>types.mbt, routes.mbt<br/>validation.mbt, logic.mbt"]

    Browser <-->|HTML + JS| Frontend
    Frontend <-->|JSON| API
    API <-->|Routes| Backend
    Backend <-->|SQL| DB

    Shared -.-|compiled for JS target| Frontend
    Shared -.-|compiled for native target| Backend

#MVU Data Flow

graph TD
    View["View<br/>view.mbt, styles.mbt"]
    Model["Model<br/>types.mbt"]
    Update["Update<br/>update.mbt"]
    Cmd["HTTP Commands<br/>GET /api/notes<br/>POST /api/notes<br/>POST /api/notes/:id/pin<br/>DELETE /api/notes/:id"]
    Server["Backend Server"]

    View -->|user interaction| Msg
    Msg -->|dispatch| Update
    Update -->|new model| Model
    Model -->|render| View
    Update -->|side effects| Cmd
    Cmd -->|request| Server
    Server -->|response| Msg

#Data Model

classDiagram
    class Note {
        id : Int
        title : String
        content : String
        pinned : Bool
    }

    class NoteStats {
        word_count : Int
        char_count : Int
        reading_time_secs : Int
    }

    Note --> NoteStats : compute_stats()

    class API {
        GET /api/notes
        POST /api/notes
        POST /api/notes/:id
        POST /api/notes/:id/pin
        DELETE /api/notes/:id
    }