DeckerDecker

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 first

Add your first project

Starter

Install 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
  1. Select your saved project in the sidebar.
  2. Press Play next to a service to start it.
  3. Wait for the status indicator to turn green.
  4. Use Stop or project-level controls when you are done.

Open local URLs

Starter

Each 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

Starter

Logs 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

Starter

Framework 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 Lifetime

Manage multiple projects

Paid

A 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

Paid

Share creates a public URL for a running local service. The service must be running before Decker can start the tunnel.

  1. Click the Share button on a running browser service's row.
  2. Choose a Share duration, from 30 minutes to 24 hours. The selection starts with your default from Settings and applies to this Share only.
  3. Choose an open link or protect the preview with a password.
  4. Copy the generated public URL after Decker verifies it.
  5. Use Preview Check after someone opens the public URL.
  6. 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

Paid

Preview 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

Paid

Deploy 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.

  1. Open Settings, then Integrations.
  2. Connect your Vercel account and approve the connection.
  3. 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.
  4. 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

Paid

GitHub 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.

  1. Open Desktop Settings, then connect GitHub Repository Access.
  2. Connect a backup repository from the project header.
  3. 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

Paid

Starter 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

Details

Settings

Reference

Open 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

Reference

Decker requests the Vercel permissions needed for deploys.

  • Deployments - create deployments and upload files
  • Projects - create and configure Vercel projects

Data and tokens

Reference

Your 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.