Shuke
Everything about Shuke (codename 述刻), the spoken-expression trainer: product, design, API, each app and service, decisions and launch. For people and agents.
Overview
What the repo holds, its tracks, the first deployed environment, and how these docs work.
Product
The PRD review and the original PRD text: who the app is for, what was decided, what is still open.
- PRD review
- PRD v1.0 (extracted text)
prd-v1.0-extracted.txt
Brand and design
The hi-fi design: brand, design system and tokens, the screen list, hi-fi screens with their data-binding maps, flows, states, onboarding, paywall, engagement, iOS handoff, screenshots.
- Design
- Brand brief
- Design system
- Design tokens
- Screens
- Hi-fi screens
- Screenshot direction
- User flows
- State matrix
- Data binding
- Onboarding
- Paywall
- Engagement
- iOS handoff
- Copy deck
- Hi-fi gallery
gallery/ - Example data
examples/ - tokens.css
tokens.css - base.css
base.css - base.js
base.js - strings.json
strings.json
API
The contracts between the apps and the backend. The OpenAPI files are the source.
- API
- API reference
reference.html - OpenAPI contract (client API)
openapi.yaml - OpenAPI contract (admin API)
openapi-admin.yaml
Backend
The Cloudflare Workers API: auth, sessions, the audio to ASR to assessment pipeline, settlement, growth, paywall, content operations.
iOS
The native iOS app, and what the App Store needs.
Landing page
The public site: home with waitlist, privacy, terms, support, in en and zh-Hans.
Dashboard
The operator dashboard for content operations, and its data binding to the admin API.
Decisions
The app's ADRs. Binding once accepted.
Go live
What must be true before launch, and every secret the app uses.