Public docs
Start with one local project. Unlock the full workflow when you need it.
This guide is public. Starter users can follow the Starter access section now. Paid sections explain Monthly or Lifetime features before the steps begin, so you always know what is available on your current access level.
Starter access
Starter- 1 saved local project
- 1 active device
- Run, stop, open, and inspect local service logs
- No Share, Deploy, Vercel integration, or GitHub backup
Monthly or Lifetime
Paid- $9 per month or $69 once
- Unlimited saved projects
- Up to 3 active devices
- Share public preview URLs
- Preview Check and shared-preview request status
- Deploy to Vercel and save GitHub backup snapshots
Starter access
Do this firstAdd your first project
StarterInstall and open Decker, then scan a local folder before you sign in. Decker asks you to confirm your account only when you save the project.
1. Scan folder
Drop a local project folder into Decker or choose it from this computer.
2. Review scan
Check the projects, localhosts, frameworks, commands, and ports Decker found.
3. Sign in
Choose GitHub or Google and confirm the matching Decker code in your browser.
4. Save project
Save the selected project. Starter keeps one saved project on one active device.
If you try to add another project on Starter access, Decker shows a paid membership prompt before scanning the new folder.
Run and stop services
Starter- Select your saved project in the sidebar.
- Press Play next to a service to start it.
- Wait for the status indicator to turn green.
- Use Stop or project-level controls when you are done.
Open local URLs
StarterEach browser service gets a local URL through Decker's proxy. Approved Simple Local URLs omit the port; otherwise Decker shows the proxy's actual runtime port. Click the URL badge to open it.
http://service.project.localhost http://service.project.localhost:1456
With frameworks like Next.js, Vite, or Nuxt, code changes often appear without refreshing. Backend frameworks may need a manual refresh.
Read logs
StarterLogs help you prove that the local project is really running. Open the Logs panel below the service row to see server output in real time.
- Check install errors and missing dependencies.
- Inspect framework output from the running dev server.
- Restart the service after fixing project files.
Supported frameworks
StarterFramework support applies before payment because Starter users need to know whether their first local project can run.
JavaScript / TypeScript
- Next.js, Vite, Nuxt, Astro
- Remix, SvelteKit, Expo
- Express, Fastify, NestJS
Python and others
- FastAPI, Flask, Django
- Streamlit, Gradio
- Flutter and Tauri-style services
Paid features
Monthly or LifetimeManage multiple projects
PaidA paid membership removes the one-project Starter limit, so Decker can keep multiple independent client apps and experiments at the same time.
A valid repository or workspace is one saved project even when it contains multiple localhosts. Starter can use every detected localhost inside its one selected project; Monthly or Lifetime is required when you save additional independent projects.
Share public previews
PaidShare creates a public URL for a running local service. The service must be running before Decker can start the tunnel.
- Click the Share button on a running browser service's row.
- Choose a Share duration, from 30 minutes to 24 hours. The selection starts with your default from Settings and applies to this Share only.
- Choose an open link or protect the preview with a password.
- Copy the generated public URL after Decker verifies it.
- Use Preview Check after someone opens the public URL.
- Stop sharing when the preview should no longer be public.
The public address belongs to the saved Share binding. Stopping or expiring a Share disconnects that session, while the same address and Tunnel can be reused the next time you Share it.
Starter users see a paid membership prompt instead of starting the tunnel.
Preview Check and Requests
PaidPreview Check appears when Share is active. It helps you confirm that the public URL was opened, the app page loaded, and no important app requests failed.
1. Share the service
Start Share on a running browser service and copy the public URL.
2. Wait for a visit
Preview Check shows when the public URL receives a request.
3. Review request status
Check whether GET / returned successfully and whether app requests failed.
4. Copy a report for AI
Send the public URL, page status, and failed app requests back to your AI coding tool.
The Requests view lists recent shared-preview requests with method, path, status, duration, and time.
Decker does not store request headers, body, or cookies in Preview Check.
Deploy to Vercel
PaidDeploy uploads project files through Vercel's API. You do not need to create a Git repository before deploying.
Vercel Deploy appears only for services with a Decker adapter: Next.js, Vite-based React, Vue, or Svelte, Nuxt, Astro, Remix, SvelteKit, and Create React App. Other supported frameworks can still run locally, but Decker does not offer Deploy for them yet.
- Open Settings, then Integrations.
- Connect your Vercel account and approve the connection.
- Click the Deploy button on a supported service's row and confirm the deployment. To deploy again after a successful deployment, select Deploy again from the service menu.
- Open the final production URL when the deployment is ready.
Starter users see a paid membership prompt before any deployment starts.
Save GitHub backup snapshots
PaidGitHub backup is separate from Vercel deploy. Decker copies the project root into a temporary Git repository and appends a snapshot to a project-specific backup branch without changing your local Git history.
- Open Desktop Settings, then connect GitHub Repository Access.
- Connect a backup repository from the project header.
- Optionally include a backup snapshot when deploying.
Decker does not change your project's local Git remote, branch, or working tree, and it does not force-push over an existing unowned remote branch. Ordinary GitHub sign-in does not request repository access.
Use up to 3 active devices
PaidStarter access works on one active device. Monthly or Lifetime work on up to three active devices owned by the same account.
You can review and remove active devices from the web dashboard if you need to use Decker somewhere else. A removed running device is signed out when it next refreshes and cannot register itself again in the background. Signing in again can reactivate that same device only when an active-device slot is available.
Reference
DetailsSettings
ReferenceOpen Settings from the desktop sidebar to manage account, appearance, startup behavior, preview preferences, integrations, and local system details.
- Account - signed-in account, providers, license, and session
- Appearance - Light, Dark, or System
- Behavior - startup and background behavior
- Preview - Simple Local URLs, fallback proxy port, and default Share Duration
- Integrations - Vercel deploy and GitHub repository access
- System - app version, OS compatibility, and updates
Vercel permissions
ReferenceDecker requests the Vercel permissions needed for deploys.
- Deployments - create deployments and upload files
- Projects - create and configure Vercel projects
Data and tokens
ReferenceYour code stays on your computer while you run local services. Sharing and deploying only happen when you explicitly click Share, Deploy, or GitHub backup.
GitHub and Vercel OAuth use an expiring, one-time server handoff. After the Desktop consumes it, integration tokens are stored in your operating system's credential store instead of Decker's local config or project files.