Workspace
Document 01 · Live

Ochre & Soul — a colouring app that celebrates Black culture.

A cross-platform Flutter colouring app for iOS and Android. Tap-to-colour numbered artworks rooted in African, Afro-Caribbean, Afro-Latin, and global Black cultural traditions. Designed to feel polished, joyful, and calm — not gamified.

Document
Stack Specification
Status
Live
Updated
2026-05-18
Chapters
22

Document
Single source of truth

Version
1.0

Date
2026-05-18

Owner
Yayra - Jude

Audience
Orchestrator agent · engineering · design

Implementation readiness

Locked: 8 · Open: 4 · Reviewed 2026-05-18

Locked for implementation

  • Anonymous‑by‑default identity model (§7.2 · §8 · §9)
  • Binary artwork bundle format CLRX v1 (§6.2)
  • Bundle lifecycle — integrity, atomic write, eviction, compat (§6.6)
  • Admin & reviewer role model with RLS enforcement (§7.2 · §7.7 · §7.8)
  • Phase 0 quantitative pass/fail criteria (§17)
  • Monetisation — packs at launch, subscription post‑MVP (§4.7)
  • Cultural review as a publish gate (§14)
  • Progress sync via region‑bitset union (§7.4)

Still open — see §20

  • OD-01 — ad‑supported free tier at launch
  • OD-05 — brotli vs gzip benchmark on mid‑range Android
  • OD-09 — artwork → regions segmentation pipeline
  • OD-10/11/12 — onboarding copy, starter artwork, pre‑permission screen

Next step: begin Phase 0 — a local Flutter canvas proof of concept measured against the exact thresholds in §17. Auth, monetisation, admin, and content‑pipeline work do not start until Phase 0 passes every criterion.

Contents
Chapter
01 Overview & vision
02 Product & cultural positioning
03 Glossary
04 Core features
05 Tech stack
06 Artwork data model
07 Data layer & RLS
08 API & function surface
09 User flows
10 Content & admin flows
11 Engineering considerations
12 Accessibility
13 Observability & analytics
14 Cultural authenticity
15 Testing & quality
16 CI/CD & release
17 Development phases
18 Orchestrator priorities
19 MVP definition
20 Open decisions
21 Dependencies
22 Build principles