Forge is an AI design application. The left panel contains the conversation. The right panel contains the live design.
You can change the theme, color, density, and font. You can also select an element and add a comment pin.
Forge supports OpenAI and Anthropic models. You can select a different provider and model for each work phase.
The conversation, design directions, and generated files stay in one workspace.
-
Install the dependencies.
npm install
-
Copy the environment example.
cp .env.local.example .env.local
-
Add a key for each provider that you use.
-
Start the development server.
npm run dev
-
Open the address that Next.js shows.
| Variable | Default | Purpose |
|---|---|---|
ANTHROPIC_API_KEY |
None | Gives access to Anthropic |
OPENAI_API_KEY |
None | Gives access to OpenAI |
FORGE_DESIGN_MODEL |
anthropic:claude-opus-4-7 |
Makes design plans |
FORGE_CODE_MODEL |
anthropic:claude-sonnet-4-6 |
Makes the full implementation |
FORGE_EDIT_MODEL |
anthropic:claude-haiku-4-5 |
Makes small changes |
Use the provider:model-id format:
FORGE_DESIGN_MODEL=openai:gpt-5.6
FORGE_CODE_MODEL=anthropic:claude-sonnet-4-6
FORGE_EDIT_MODEL=openai:gpt-5.6Forge does not limit the model ID. Thus, you can select a new GPT or Claude model without a source-code change.
You can also set the provider and model in separate variables. Read .env.local.example for all options.
- The browser sends the conversation and control values to
POST /api/chat. - The server selects the provider for each work phase.
- Forge uses the OpenAI Responses API or the Anthropic Messages API.
- The model returns the Forge response protocol.
- The protocol contains
<reply>,<design_plan>,<files>, and<edits>channels. - Forge puts the HTML in a restricted iframe.
- The controls change CSS variables in the iframe.
- Forge saves each version in browser local storage.
Select Send to Claude Code. Forge makes a ZIP file with this name:
forge-handoff-<project>-<timestamp>.zip
The ZIP file contains these files:
CORE.htmldesign-tokens.csscomponents.jsonPROMPT.mdhandoff-instructions.md
Put the files in a location that Claude Code can access. Then, paste the generated prompt into Claude Code.
Forge uses Next.js 15, React 19, TypeScript, the OpenAI SDK, the Anthropic SDK, and JSZip.
Read CONTRIBUTING.md before you submit a change. Report security problems as specified in SECURITY.md.
Forge uses the PolyForm Noncommercial License 1.0.0. The same license applies to Orchestra.
You can use Forge for evaluation, education, personal projects, and nonprofit work. Business use requires written permission and separate terms from One Man Labs.

