Create an app
By the end of this page you will have generated your first Web or Mobile app from a prompt.
Prerequisites
- A project created (Create your first project).
Steps
Navigate to Apps
In your project sidebar, click Apps. You land on the Create Apps page — this shows the platform selector, the prompt composer, and a View Apps button linking to your existing apps.
Choose a platform
The platform selector shows three cards:
| Platform | Label | Notes |
|---|---|---|
| Web | Web | Selected by default |
| Mobile | Mobile | Tagged Preview — mobile app generation is still in preview |
| Copilot | Copilot | Opens a separate creation wizard, not covered in this guide yet |
Click Web or Mobile. The prompt composer below updates its placeholder text (Describe your web app… or Describe your mobile app…) and its quick suggestions.
Quick suggestions differ by platform. Web offers Task management app, E-commerce dashboard, Blog with CMS, and Chat application. Mobile offers Fitness tracker, Recipe app, Expense tracker, and Notes app. Click one to prefill the prompt box.
Describe your app
Write a natural language description of the app you want (up to 6,000 characters). The more specific you are about entities, workflows, and user roles, the fewer clarifying questions qRaptor needs to ask later.
You can also:
- Attach files — up to 5 images or PDFs, for visual references (mockups, screenshots, brand guidelines).
- Add reference URLs — link to existing sites or apps for design inspiration.
Configure Auth and Environment
Two settings sit alongside the prompt box:
- Auth — a chip toggle that enables authentication on the generated app. This is the only place to turn it on — see Secure your app for what happens once it’s enabled.
- Environment — choose Shared or Dedicated. Dedicated gives your app its own database schema; Shared uses a common schema across apps in the project.
Connect GitHub (optional)
Connect a GitHub repository so your generated code is pushed and synced automatically. If you skip this, you can connect a repo later from Workspace Settings.
Generate your app
Click Generate App. qRaptor creates a new workspace and takes you into the full-screen app builder, where generation begins immediately.
What happens next — turning your prompt into requirements, an app graph, and working code — is covered in The generation flow.
Common issues
- Prompt too short or vague — qRaptor will ask more clarifying questions during the Requirements step. A more specific prompt up front means fewer of these.
- Mobile app behaves unexpectedly — Mobile generation is in Preview; some capabilities available for Web may not yet be supported.
- GitHub connect fails — Confirm your GitHub account is authorized for the organization and that you have permission to create repositories.