Documentation

Everything you need to deploy your frontend projects with One Deploy.

1Quick Start

Connect Your Repository

Click the "Connect GitHub" button on your dashboard to authorize One Deploy to access your repositories.

Select a Project

Choose the repository you want to deploy. We support any static frontend project including Next.js, React, Vue, and plain HTML/CSS.

Deploy

Click "Deploy Now" and watch the magic happen. Your site will be live at your-repo.onedeploy.dev in seconds.

2Configuration

Build Settings

One Deploy automatically detects your project type and configures build settings. You can override these in your project settings.

{
  "buildCommand": "npm run build",
  "outputDirectory": "out",
  "nodeVersion": "20"
}

Environment Variables

Add environment variables in your project settings. They'll be available during the build process.

3GitHub Actions

For automatic deployments on every push, add this workflow to your repository:

name: Build & Deploy
on:
  push:
    branches: [main]
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: '20'
      - run: npm ci
      - run: npm run build
      - uses: cloudflare/pages-action@v1
        with:
          apiToken: ${{ secrets.CF_API_TOKEN }}
          accountId: ${{ secrets.CF_ACCOUNT_ID }}
          projectName: your-project
          directory: ./out

4Custom Domains

Add a custom domain to your project by adding a CNAME record pointing to your One Deploy URL:

Type	Name	Value
CNAME	www	your-project.onedeploy.dev

SSL certificates are automatically provisioned for all custom domains.