Oneshot
Docs
Back to home
Getting StartedHow It WorksCredits & PricingFAQ

How Oneshot Works

Oneshot uses AI to take you from idea to deployed app through a structured workflow.

The Workflow

1. Scope Your Idea

What happens: Oneshot acts as a product consultant, guiding you through a conversation to define what you want to build. It covers requirements, design, and technical architecture in one streamlined step.

You'll get:

  • Clear project overview and goals
  • List of features and requirements
  • Technical architecture and data models
  • UX flow and screen-by-screen breakdown
  • Design direction and component specifications

Tip: Be as detailed as possible about what you want. Mention specific features, share examples of apps you like, and describe any design preferences.

2. Build & Iterate

Once the scoping is complete, Oneshot builds your app:

  1. Code Generation: AI writes production-ready code based on the plan
  2. Live Preview: See your app running in a sandbox environment
  3. Iterate: Chat with Oneshot to make changes and improvements

3. Deploy

One click to go live. Your app is deployed to production with a public URL.

Model Selection

Oneshot gives you the flexibility to choose which AI model powers your builds and chats. You can select from a range of models in the build dashboard.

Available models include:

  • Claude Sonnet 4 — Great balance of speed and quality (default)
  • Claude Opus 4 — Most capable, best for complex projects
  • GPT-4o / GPT-4.1 — OpenAI's latest models
  • Gemini 2.5 Pro / Flash — Google's models, great value
  • DeepSeek — Cost-effective for simpler tasks
  • And more — the model list is updated regularly

Your model selection is saved per project and persists across sessions. Different models have different credit costs — see Credits & Pricing for details.

Bring Your Own Provider

Pro subscribers can connect their own AI provider API keys (e.g., Anthropic, OpenAI) to use their own accounts for code generation. This means:

  • No credit usage for sandbox operations — builds and chats use your own API key
  • Full model access — use any model your provider supports
  • Pay your provider directly at their published rates

To connect your provider, open the config panel in the build dashboard and click the provider you want to connect. You'll be guided through an OAuth flow to authorize access.

Note: Bring Your Own Provider requires an active Pro subscription. Credit packs and free credits still work with the built-in models.

Making Changes

Need to update your app? Just tell Oneshot what you want:

  • "Add a dark mode toggle"
  • "Change the hero section background to blue"
  • "Add a newsletter signup form to the footer"
  • "Make the buttons rounded"

Oneshot will update your app and show you the changes in real-time. You can also attach images as visual references for your changes.

Technology Stack

Oneshot builds modern web applications using:

  • Frontend: React, Next.js, Astro, Tailwind CSS
  • Backend: Node.js, API routes
  • Database: Supabase (PostgreSQL)
  • Hosting: Container-based deployment
  • Authentication: Built-in auth when needed

You don't need to know these technologies — Oneshot handles everything.

Deployment

When you deploy:

  1. Your app is built and optimized for production
  2. It's deployed to cloud infrastructure
  3. You get a URL: yourproject.oneshotapp.io
  4. SSL certificate is automatically configured

Custom Domains (Pro)

With a Pro subscription, you can:

  • Connect your own domain (e.g., myapp.com)
  • Bring your own AI provider
  • Get priority support

Questions? Check our FAQ or email hello@oneshot.dev