Skip to main content

Plan mode in 23 seconds. Turn the sound on for the music.

Plan mode makes Rork think before it builds. You describe the app or the change, Rork asks a few questions, and it writes a plan. It changes no code until you press Build. For a new app, the plan also draws the app’s key screens and a small diagram of how they connect. You see the whole app before a single file exists, and a change costs one message instead of a rebuild.

​
Turn on Plan mode

The mode menu sits next to the model picker in the composer. It shows the current mode, Build by default. Open it and pick Plan.
The Rork composer with the mode menu open. Three rows: Build, Build and edit your app. Plan, Plan the features and screens before building. Design, Explore the look before building.

The mode menu. Before an app exists, Plan reads “Plan the features and screens before building”.

The same menu sits on the home screen and inside every project. Only one mode is on at a time: picking Plan turns Design off. Two faster ways in:
  • On the home screen, press P when you are not typing. It switches Plan on or off and opens the menu so you see the change.
  • Open rork.com/?plan=true. The home screen opens with Plan already on.
Plan mode stays on for the project until you press Build on a plan, pick Build in the menu, or approve Return to Agent Mode?. Rork remembers the choice in your browser, so it survives a reload.

​
How a plan comes together

1

Send your idea

Describe the app or the change in plain words. You do not need a spec. “A habit tracker with daily check-ins, streaks and weekly stats” is enough.
2

Rork reads before it writes

Rork looks through your project and, when it helps, the web. In Plan mode it can read but not write: every tool that changes files is switched off.
3

Answer the questions

Rork batches its open questions into one Questions card. Colors and layouts come as pictures, so you pick a look instead of describing one. Type your own answer in Other…, or press Skip. Press Submit when you are done.
4

Read the plan

Rork writes the plan and shows a Review Plan card at the end of its answer. View Plan opens the plan in the panel on the right. For a new app, the screens fill in as Rork draws them.
5

Change it, or build it

Reply in chat to change the plan. When it is right, press Build.
A Rork Questions card on question 4 of 4, Which colors should it use, with four palette tiles named Soft orb, Still pond, Night glow and Warm clay, then Surprise me, an Other field, Skip and Submit

Questions arrive in one card. A color question shows each option as a palette.

Rork asks at most two rounds of questions. After that it writes the plan with what it knows, so a plan never turns into an interview.

​
What a plan contains

A plan is written for a person, not for a programmer. It describes what the app does and how it looks. It never lists file names, libraries, or code.
A Rork plan open in the plan panel: four drawn screens named Today, Habits, Calendar and Stats, then a Features list, a Flow diagram from Today to Habit list to Calendar to Weekly stats, and two Goals, each with a done-when line

A new app’s plan: its screens, then Features, Flow, and Goals.

A small change gets a small plan. A new app gets a fuller one. A plan can also show pictures, for example a reference design Rork found or a screen your app already has, and a diagram box can carry a screen.
The plan panel for a meditation app called Serene Moment, with a Close button and ESC hint in the header, and a Flow diagram where Timer leads to Session, Sounds and Journey, each box showing its screen

A Flow diagram whose boxes show the drawn screens. Close the panel with Close or Esc.

The plan panel is read-only. To change a plan, ask Rork in chat. This keeps the plan Rork reads and the plan you read the same file.

​
Tutorial 1: plan a new app

This walkthrough takes about five minutes. You end with a plan, drawn screens, and a running app.
1

Pick Plan and send your idea

On the home screen, open the mode menu and pick Plan. Type your idea and send it.
2

Answer the questions

Rork usually asks what the app is mainly for and which features the first version must have. Then it asks one to three questions about the look, unless your message already settles it. Pick the answers that feel right and press Submit.
3

Watch the plan and its screens arrive

The plan opens on the right by itself, because a new project has no preview yet. The screens fill in one by one. Scroll down for Features, Flow, and Goals.
4

Press Build

The Review Plan card waits at the end of Rork’s answer. Press Build. Rork switches Plan mode off, opens the preview, and builds the app from the plan and its screens.
Put the look into your first message and Rork has fewer questions to ask. “A calm habit tracker, white background, green accents” settles most of the design questions before they come up.

​
Tutorial 2: change the plan before you build

The cheapest moment to change your mind is before the build. Every change here costs one message, not a rebuild.
1

Keep Plan mode on

After the first plan, the mode menu still reads Plan. Leave it that way.
2

Ask for the change in chat

Say what you want in plain words. Rork edits the same plan file instead of starting a new one.
3

Check what changed

For a new app, Rork redraws only the screens the change affects. A visual change, like “make it orange”, updates the screens and the plan’s Design section together.
4

Build when it is right

The Review Plan card moves to Rork’s latest answer. Press Build there.
Good change requests are short and specific:

​
Tutorial 3: plan a big change in an app you already have

Plan mode is not only for new apps. Use it before a change that touches many screens, like accounts, payments, or a new section.
1

Open the project and pick Plan

Open the mode menu in the project’s composer and pick Plan. In an existing app, the row reads “Map out the work before building”.
2

Describe the outcome

Say what people should be able to do, not how to code it.
3

Read the plan

Rork reads your code first, so the plan fits the app you have. A plan for an existing app has no drawn screens: your preview already shows the app. Press View Plan to read it.
A Rork Review Plan card under the line Created plan: Recipe box, with the overview Save the recipes you love and turn any of them into a shopping list, and View Plan and Build buttons

The Review Plan card. View Plan opens the plan, Build starts the work.

4

Build

Press Build. Rork sends Build the plan. for you, turns Plan mode off, and works through the plan. It ticks off each item as it finishes it.
You can also type “go” instead of pressing Build. Rork then shows a Return to Agent Mode? card. Press Approve and it starts building.

​
When Rork suggests Plan mode

In Build mode, Rork can ask to switch when a request looks large or has several sensible answers. A Switch to Plan Mode? card appears with a short reason.
  • Approve turns Plan mode on, and Rork plans before it builds.
  • Decline keeps Build mode, and Rork goes on with your request.
  • No answer in 30 seconds cancels the switch. The card shows how many seconds are left.
Rork asks at most once per message. If you asked for a plan yourself and the switch timed out, Rork stops and asks you to approve it or turn on Plan in the menu.

​
After you press Build

  • Build sends Build the plan. and switches Plan mode off for you. No extra approval is needed.
  • The card then shows Built instead of Build. View Plan stays, so you can reopen the plan at any time.
  • Rork keeps the latest plan in front of it on every later message, and ticks off items as it finishes them.
  • Each goal becomes its own task. Rork marks a goal done only when its “done when” line is true, or it tells you what is missing.
Plans live in .rork/plans/ in your project, one file per plan. They travel with your code to GitHub, but they stay out of the file tree in Rork.

​
What Plan mode cannot do

  • It does not change code. Rork only reads, asks, and writes the plan.
  • You cannot edit the plan by hand in Rork. The plan panel is read-only, so ask Rork in chat.
  • Drawn screens are for new apps only. Once the app exists, a plan is text, pictures, and a diagram.
  • Rork asks at most two rounds of questions per plan.
  • The mode menu hides while a Design mode session is open. Finish the design or build it first.
  • A plan is a strong guide, not a promise of the exact result. Check the preview after the build and ask for fixes as usual.

​
FAQ

Plan mode has no separate price. A plan message spends build credits like any other message. For a new app, the drawn screens add to the cost of that message, the same way Design mode screens do. See Build credits vs Cloud credits.
Design mode is about the look: it proposes screens and nothing else. Plan mode covers the whole app: features, screens, flow, and goals. For a new app, a plan includes its screens, so you get the design inside the plan. See Design mode.
Rork starts building from the plan. Stop the message, or let it finish and roll back with Undo and version history. The plan file stays, so you can press View Plan and continue later.
Every plan is its own file in .rork/plans/, and Rork follows the newest one. Ask Rork in chat to bring parts of an older plan back into the current plan.
No. After 30 seconds the card says the switch timed out, and Rork goes on in Build mode. Turn on Plan in the menu and send the message again if you want a plan.
Yes. On a phone, the mode menu opens as a dialog in the middle of the screen. Pick Plan there.

​
Next steps

Design mode

Settle the look of a new app before you build.

How to prompt successfully

Write the first message that makes a good plan.

Element Selection

After the build, point at a part of the app and change it.

Undo and version history

Roll back a build you did not like.