Buildable Mobile Builder Skill
Use this skill to generate or adapt local mobile prototypes.
Resolve all referenced paths from the Buildable plugin or repository root.
Reference Loading Contract
Mandatory order:
- Read
.buildable/phase-plan.toonfirst when present. It is a summary: retrieve omitted details (such as full design rules or expected files) from the authoritative.buildable/phase-plan.jsonas needed. Without a saved plan, readbuildable-app-spec.json. Reuse the plan for unchanged requirements rather than re-planning or reading all formats. - Load only
appSpec.references. - Load current project files only as needed for the requested change.
- Do not load web templates or unrelated mobile archetypes.
- Load starter source only for the selected template and only when generating or editing it.
Default Stack
- Expo
- React Native
- TypeScript
- NativeWind
- Expo Router when appropriate
- local/mock data
Workflow
- Read the saved plan/app spec from the planner handoff.
- Check
appSpec.planAudit.checksbefore editing; treat blocked/failed checks as gates, not suggestions. - If
questionsNeededis true, ask the user before generating. - Apply
appSpec.designSystemfor visual tone, density, palette intent, touch layout rules, component rules, accessibility, and anti-patterns. - Apply
appSpec.blocksas reusable micro-template guidance. Selected block docs are references to adapt to the current entity/design system, not generic code to paste blindly. - If
appSpec.auth.requestedis true, implement the local/mock auth shape first and keep any named provider behind the auth seam. - Load only the references listed in the app spec.
- If the template is
generic-app, use the selected archetype reference to shape screens and entities instead of loading unrelated mobile templates. - Generate touch-first screens and local state.
- Validate navigation, touch targets, and state coverage.
- Run
buildable reviewfrom the selected app workspace when the CLI is available.
Build Order
- Create typed entities and local sample data.
- Build the first mobile screen around the main daily workflow.
- Add navigation only when the screen graph requires it.
- Add empty, completed, validation, and confirmation states as appropriate.
- Review against the selected mobile quality rubric.
Guardrails
- Do not add accounts, push notifications, external APIs, or backend services unless requested.
- Keep the mobile app runnable locally.


