How App Factory Works

App Factory is an AI-native pipeline that transforms market research into production-ready mobile apps. Three commands, ten stages, one complete app.

The Command Interface

App Factory exposes a simple, deterministic command interface. Each command triggers a specific pipeline execution mode.

1
run app factory
Generate 10 ranked app ideas

Executes Stage 01 market research. Creates an 'idea bin' with 10 validated app concepts, ranked by market evidence and complexity score. Ideas remain unbuilt until you choose which to pursue.

2
build <IDEA_NAME>
Build one selected idea

Builds ONE selected idea from your idea bin through Stages 02-10. Creates a complete, store-ready Expo React Native app with subscriptions, proper navigation, and all assets.

3
dream <IDEA_TEXT>
End-to-end from raw idea

Transforms a raw idea text into a complete app in one execution. Runs all stages (01-10) sequentially, producing a store-ready mobile app from your concept.

The 10-Stage Pipeline

Each stage produces validated artifacts that feed into the next. Quality gates ensure completeness before progression.

01
Market Research
02
Product Spec
03
UX Design
04
Monetization
05
Architecture
06
Builder Handoff
07
Polish
08
Brand
09
Release Planning
10
App Generation

Core Principles

App Factory is built on principles of determinism, validation, and auditability.

Truth is Files on Disk

Every stage writes validated JSON artifacts. If it's not on disk with a valid schema, it didn't happen. No hand-waving or implicit state.

Selective Execution

Generate many ideas, build few. The selective model lets you invest compute only in concepts you want to pursue. Most ideas stay in the bin.

Quality Gates

Hard checkpoints at 02.5, 02.7, 09.5, and 10.1 verify that specifications are complete and consistent before code generation begins.

Fail Fast

Schema validation failures stop execution immediately. Missing artifacts cause hard failures with detailed error reports. No partial success states.

What You Get

Each successful build produces a complete, store-ready React Native app.

builds/<idea_dir>/<build_id>/app/text
app/
├── package.json          # Expo + RevenueCat dependencies
├── app.json              # Expo configuration
├── App.tsx               # Entry point
├── src/
│   ├── screens/          # All app screens
│   │   ├── Onboarding/
│   │   ├── Paywall/
│   │   ├── Settings/
│   │   └── ...
│   ├── components/       # Reusable UI components
│   ├── services/         # RevenueCat, storage, etc.
│   ├── navigation/       # Expo Router config
│   └── theme/            # Design tokens
├── assets/               # Icons, splash, images
└── README.md             # Build documentation

Ready to start?

Follow the getting started guide to install App Factory and run your first pipeline.