{"schemaVersion":"1","contentVersion":"2026-11-01.13","slug":"create-project","title":"Create an application","summary":"Start with an idea and let Rumata prepare your workspace.","category":"User Manual","outcome":"A new factory with your first request submitted in Plan mode.","minutes":4,"prerequisites":[],"related":["controls-home-account","controls-factory"],"sources":["Live app.rumata.dev, September 29 2026; product evidence in docs/journey-verification-2026-09-29.md; current example in docs/collab-journey-verification-2026-09-29.md","Current product source at 7d6705f2e"],"manual":true,"technical":[],"sections":[{"id":"first-prompt","title":"Start with a prompt","blocks":[{"type":"paragraph","text":"Describe the application you want to create in your own words."},{"type":"paragraph","text":"On [Home](https://app.rumata.dev/), select the large prompt box. The Send arrow beside it submits the prompt."},{"type":"paragraph","text":"Explain who the app is for, the main task they should accomplish, and the essential features for a first version. Press [Shift + Return](/guides/controls-home-account#first-prompt-controls) to add another line."},{"type":"paragraph","text":"Optional wording you can adapt:"},{"type":"code","language":"text","text":"Build an app for [audience] to [main task]. Start with [essential features]. It should [important behavior or constraints]. Plan the first version before building it and ask about anything unclear."},{"type":"note","title":"Check your result","text":"Your prompt remains a draft until you send it. If nothing appears in the conversation, complete the project and Send steps below."},{"type":"paragraph","text":"Learn more: [Home prompt controls](/guides/controls-home-account#first-prompt-controls)"}]},{"id":"project","title":"Your project is selected automatically","blocks":[{"type":"paragraph","text":"Every factory is created within a project. Rumata selects the project automatically for you."},{"type":"paragraph","text":"Learn more: [Learn more about projects and factories](/guides/understand-project)"}]},{"id":"mode","title":"Keep the first request in Plan mode","blocks":[{"type":"paragraph","text":"Review Rumata’s approach before building begins."},{"type":"paragraph","text":"On Home, find the Plan or Build toggle beside Select project. Selecting it changes the mode directly."},{"type":"paragraph","text":"Keep Plan selected for your first application. If the toggle shows Build, select it to switch to Plan."},{"type":"note","title":"Check your result","text":"Rumata will plan first when you send your prompt. [Factory Settings](/guides/controls-factory#factory-details) is beside the prompt controls and is optional for this walkthrough."},{"type":"paragraph","text":"Learn more: [Prompt modes and optional settings](/guides/controls-home-account#first-prompt-controls)"}]},{"id":"context","title":"Add useful context","blocks":[{"type":"paragraph","text":"Include the details that matter to your application."},{"type":"paragraph","text":"Add your requirements to the [Home](https://app.rumata.dev/) prompt. You can attach files to this first prompt too, such as a specification, reference image, or supporting document."},{"type":"paragraph","text":"Describe your requirements and attach any files you want Rumata to use as context before sending your first prompt."},{"type":"note","title":"Check your result","text":"Your first prompt includes your requirements and attached files. You can add more files later in the workspace chat."},{"type":"paragraph","text":"Learn more: [Add files in the workspace](/guides/workspace#attachments)"}]},{"id":"send","title":"Create the factory and submit your prompt","blocks":[{"type":"paragraph","text":"Check your prompt and selected project before sending."},{"type":"paragraph","text":"Use the [Send](/guides/controls-home-account#first-prompt-controls) arrow to submit your prompt. It becomes available once the required input is complete and Rumata is ready."},{"type":"steps","items":["Check the project, Plan mode, and prompt text.","Select Send once and wait for the factory workspace to open.","Check the conversation for your submitted message; typing text without sending it does not start a build."]},{"type":"note","title":"Check your result","text":"The new factory opens inside the selected project. Wait for its development machine to connect, then continue to [Work in Your Project](/guides/workspace). If Send stays disabled, check the prompt and selected project; if startup fails, use the [preview troubleshooting steps](/guides/troubleshooting#preview)."},{"type":"paragraph","text":"Learn more: [First-prompt controls](/guides/controls-home-account#first-prompt-controls)"}]}],"updated":"2026-10-05","audience":"general","media":[{"src":"https://docs.rumata.dev/media/manual/startup.jpg","width":1096,"height":733,"alt":"Rumata Preview panel displaying Preparing your canvas while the development workspace becomes available.","caption":"During startup, Rumata prepares the workspace before the preview becomes usable. Wait for the chat and preview to connect.","sectionId":"send"}],"video":null,"url":"https://docs.rumata.dev/guides/create-project"}