Deploy a React app on Nept

This guide covers deploying a React app to Nept — whether you scaffolded it with Vite, Create React App, Remix, or a custom setup.

If your React app uses Vite specifically, see also Deploy a Vite app. If it uses Next.js, see Deploy a Next.js app.

Prerequisites

• A Nept account.
• A React project with a working build script in package.json.

Option A: Deploy from GitHub

1. Connect GitHub.
2. Click New project and pick your React repository.
3. Nept detects the framework and pre-fills the build command. If needed, override to npm run build.
4. Set the output directory (build for CRA, dist for Vite/others).
5. Add environment variables — remember that CRA and Vite have different env var conventions.
6. Click Deploy.

Option B: Deploy with the CLI

npm install -g nept-cli
nept login
cd my-react-app
nept deploy --prod

Nept runs your build script and serves the output over a global CDN.

Environment variables

React frameworks each have their own env var prefix:

• Vite: variables must start with VITE_ to be exposed to the client.
• Create React App: variables must start with REACT_APP_.
• Next.js: variables exposed to the browser must start with NEXT_PUBLIC_.

See Environment Variables.

Custom domains

Attach a custom domain from the dashboard or CLI. See Custom Domains.

Managed database

Full-stack React apps can attach a managed Postgres database:

nept db create --type postgres

See Databases.

Next steps

• Deploy a Vite app
• Deploy a Next.js app
• Deploy from GitHub
• Custom Domains