App Factory

Describe it. Build it. Ship it.

App Factory turns your ideas into real, working products. No coding experience required. Just describe what you want in plain English, and Claude builds it.

What Can I Build?

I want to make...	Use this	What you get
A mobile app	app-factory/	iPhone & Android app ready for the App Store
A dApp / website	dapp-factory/	Modern web app, optionally with AI agents
An AI agent	agent-factory/	Smart bot with tools (Rig-aligned architecture)
A Claude plugin	plugin-factory/	Extension for Claude Code or Claude Desktop
A Base Mini App	miniapp-pipeline/	Mini app for the Base app (MiniKit + Next.js)

Quick Start Commands

For Mobile Apps

cd app-factory
claude
# Type your app idea
# When done: cd builds/<your-app> && npm install && npx expo start

For dApps / Websites

cd dapp-factory
claude
# Type your dApp idea
# When done: cd dapp-builds/<your-dapp> && npm install && npm run dev
# Open http://localhost:3000

For AI Agents

cd agent-factory
claude
# Type your agent idea
# When done: cd outputs/<your-agent> && npm install && npm run dev
# Test: curl http://localhost:8080/health

For Claude Plugins

cd plugin-factory
claude
# Type your plugin idea
# When done (Claude Code plugin): Copy builds/<plugin>/ to your project
# When done (MCP server): cd builds/<plugin> && npm install && npm run build

For Base Mini Apps

cd miniapp-pipeline
claude
# Type your mini app idea
# When done: cd builds/miniapps/<your-app>/app && npm install && npm run dev
# Deploy to Vercel, complete account association, post URL in Base app

How It Works

Step 1: Pick Your Project Type

Want a mobile app?     → Go to app-factory folder
Want a dApp/website?   → Go to dapp-factory folder
Want an AI agent?      → Go to agent-factory folder
Want a Claude plugin?  → Go to plugin-factory folder
Want a Base Mini App?  → Go to miniapp-pipeline folder

Step 2: Open Claude and Describe Your Idea

cd app-factory    # (or dapp-factory, or agent-factory)
claude

Then just type what you want:

"I want to make an app where you fly a plane"

"I want to make a meme battle website where people vote on memes"

"Build an agent that summarizes YouTube videos"

"I want a plugin that formats code on save"

"Build a mini app for sharing daily gratitude with friends"

Step 3: Let the AI Build It

The AI will:

Understand your idea - Turn your simple description into a detailed plan
Research the market - Find competitors and figure out what makes yours special
Build everything - Create all the code, designs, and documentation
Check quality - Review its own work and fix any issues

Step 4: Run Your Creation

When it's done, you'll get step-by-step instructions to run your new app, website, or AI assistant on your computer.

The Secret Sauce: Intent Normalization

You don't need to be specific. Our AI fills in the gaps.

What you say:

"make me a meditation app"

What the AI understands:

"A premium meditation app with guided sessions, progress tracking, streak calendars, ambient sounds, and subscription monetization. Features smooth animations, offline support, and a calming dark-mode design."

The AI adds all the details that make a great product, so you just focus on the idea.

Quality Guarantee: Ralph Mode

Every project goes through "Ralph Mode" - our quality checker that acts like a picky reviewer.

Ralph checks:

Does the code actually run?
Does everything look polished?
Is the research real and useful?
Are there any bugs or issues?

Ralph won't let a project finish until it's at least 97% perfect.

If something's wrong, the AI fixes it automatically. You only see the final, working result.

UX Polish Loop (Playwright E2E)

UI-generating pipelines (websites, dApps) include automated Playwright E2E testing for extra quality assurance.

What's Included

Every UI project gets:

ralph/ - PRD, acceptance criteria, progress tracking
tests/e2e/ - Smoke tests, form tests, accessibility checks
playwright.config.ts - Multi-browser test configuration
scripts/ralph_loop_runner.sh - 20-pass polish runner

How It Works

cd dapp-builds/<your-project>
npm install
npm run test:e2e       # Run Playwright tests
npm run polish:ux      # Run full 20-pass polish loop

The loop continues until a "completion promise" is earned - proof that all acceptance criteria are verified.

Which Pipelines?

Pipeline	Playwright
website-pipeline	Required
dapp-factory	Required
miniapp-pipeline	Optional (for verification)
app-factory	Optional (for web exports)
agent-factory	Not needed (HTTP API)
plugin-factory	Not needed (CLI)

See docs/UX_POLISH_LOOP.md for full documentation.

Real Examples

Mobile App Example

You say: "I want to make an app where you fly a plane"

You get:

A complete iPhone/Android game with plane controls
App Store listing with title, description, and keywords
Marketing research showing similar apps and your advantages
Everything you need to publish to the App Store

Website Example

You say: "I want to make a meme battle arena where people vote on memes"

You get:

A polished website with smooth animations
Voting system, leaderboards, and user submissions
Mobile-friendly design that works on any screen
Ready to deploy to the internet

AI Agent Example

You say: "Build an agent that summarizes YouTube videos"

You get:

A working AI that accepts video links and returns summaries
Simple API you can connect to other apps
Documentation explaining how it all works
Ready to run on your computer or a server

Claude Plugin Example

You say: "I want a plugin that formats code on save"

You get:

A complete Claude Code plugin with hooks and commands
Auto-formatting whenever you save a file
Support for multiple formatters (Prettier, ESLint, Black, etc.)
Security documentation and installation guide

Base Mini App Example

You say: "Build a mini app for sharing daily gratitude with friends"

You get:

A complete Next.js app with MiniKit integration
Manifest configuration for Base discovery
Account association instructions and validation
Step-by-step deployment and publication guide

What's Inside Each Project

Mobile Apps Include:

Complete app code (TypeScript + React Native)
App Store listing materials
Market research and competitor analysis
Privacy policy and legal docs
Step-by-step launch instructions

Websites Include:

Complete website code (TypeScript + Next.js)
Modern design with animations
Mobile-responsive layout
Market research and positioning
Deployment instructions

AI Agents Include:

Complete server code (TypeScript + Node.js)
API endpoints ready to use
Market research and positioning
Testing and deployment guides

Claude Plugins Include:

Complete plugin structure (commands, hooks, or MCP server)
Security documentation
Installation instructions
Usage examples
MCPB packaging guide (for MCP servers)

Base Mini Apps Include:

Complete Next.js app with MiniKit integration
Manifest configuration (minikit.config.ts)
Manifest route (/.well-known/farcaster.json)
Placeholder assets (icon, splash, hero, screenshots)
Account association instructions
Vercel deployment guide
Publication checklist
Ralph QA review artifacts

Folder Structure

AppFactory/
├── app-factory/       # Mobile app builder
├── dapp-factory/      # dApp/website builder (with optional AI agents)
├── agent-factory/     # AI agent builder (Rig-aligned)
├── plugin-factory/    # Claude plugin builder
├── miniapp-pipeline/  # Base Mini App builder (MiniKit + Next.js)
├── references/        # Reference implementations (Rig framework)
├── vendor/            # Cached documentation (Base Mini Apps docs)
└── docs/              # Architecture docs and learning materials

Each folder is independent. Just pick one and start building.

Claude Plugin: Factory

Factory is the official Claude plugin for AppFactory. It provides a governed command interface for planning pipelines, running builds, and performing adversarial QA inside this repository. Factory requires explicit user approval before execution, operates offline by default, writes files only to designated output directories, and collects no telemetry. It is designed for AppFactory contributors and is not intended to operate as a standalone plugin.

See plugins/factory/ for documentation.

Optional: Add Tokens

Want to add cryptocurrency features? Just say "yes" when asked about token integration.

Default: No crypto, no blockchain, just a normal app
With tokens: Add payments, rewards, or premium features using Solana

You don't need to understand crypto - the AI handles all the technical stuff.

Troubleshooting

"npm install fails"

npm install --legacy-peer-deps

"Port already in use"

# For websites
PORT=3001 npm run dev

# For AI assistants
PORT=3001 npm run dev

"Something's not working"

Check the runs/ folder in your project - there's a detailed log of what happened and any issues found.

Support the Project

Hold $FACTORY on Solana to support ongoing development.

Contract Address: BkSbFrDMkfkoG4NDUwadEGeQgVwoXkR3F3P1MPUnBAGS

AI Agent Architecture: Rig Integration

The agent-factory and dapp-factory pipelines are now aligned with the Rig framework by 0xPlaygrounds - a production-grade Rust library for building LLM-powered applications.

What this means for you:

Agents follow real architectural patterns (not tutorial code)
Tools have proper typed definitions
Generated code can scale to production
Clear learning path from TypeScript scaffolds to Rust production

See /docs/architecture/ for detailed documentation.

Version History

Version	What Changed
v11.0	Added miniapp-pipeline for Base Mini Apps (MiniKit + Next.js)
v10.0	UX Polish Loop with Playwright E2E testing for UI pipelines
v9.0	Rig integration, renamed web3-factory → dapp-factory, agent decision gate
v8.0	Added plugin-factory for Claude Code plugins and MCP servers
v7.0	Added Intent Normalization and Ralph Quality Mode to all pipelines
v5.0	Factory Ready Standard, unified documentation
v4.0	Single-mode refactor, Ralph QA process

License

MIT License - Free to use, modify, and share.

App Factory v11.0
Tell us what you want. We'll make it for you.

Name		Name	Last commit message	Last commit date
Latest commit History 55 Commits
.claude/commands		.claude/commands
.factory-tools		.factory-tools
.github		.github
CLI		CLI
agent-factory		agent-factory
app-factory		app-factory
dapp-factory		dapp-factory
docs		docs
miniapp-pipeline		miniapp-pipeline
plugin-factory		plugin-factory
plugins/factory		plugins/factory
ralph		ralph
scripts		scripts
vendor		vendor
verification		verification
website-pipeline		website-pipeline
.gitignore		.gitignore
CLAUDE.md		CLAUDE.md
README.md		README.md
SUBMISSION.md		SUBMISSION.md

Folders and files

Latest commit

History

Repository files navigation

App Factory

What Can I Build?

Quick Start Commands

For Mobile Apps

For dApps / Websites

For AI Agents

For Claude Plugins

For Base Mini Apps

How It Works

Step 1: Pick Your Project Type

Step 2: Open Claude and Describe Your Idea

Step 3: Let the AI Build It

Step 4: Run Your Creation

The Secret Sauce: Intent Normalization

Quality Guarantee: Ralph Mode

UX Polish Loop (Playwright E2E)

What's Included

How It Works

Which Pipelines?

Real Examples

Mobile App Example

Website Example

AI Agent Example

Claude Plugin Example

Base Mini App Example

What's Inside Each Project

Mobile Apps Include:

Websites Include:

AI Agents Include:

Claude Plugins Include:

Base Mini Apps Include:

Folder Structure

Claude Plugin: Factory

Optional: Add Tokens

Troubleshooting

"npm install fails"

"Port already in use"

"Something's not working"

Support the Project

AI Agent Architecture: Rig Integration

Version History

License

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages