# Deployment Guide

## One-Click Deploy (Recommended)

Click the "Deploy to Cloudflare" button on the GitHub repo — that's it!

The deploy button automatically:
- Forks the repo to your GitHub account
- Creates a Cloudflare Pages project
- Provisions a D1 database
- Runs the database migrations
- Sets up your AUTH_KEY secret
- Deploys the application

Your pastebin will be live in under 60 seconds. No configuration needed.

## Manual Deployment

### Prerequisites

- Node.js 18+
- A Cloudflare account
- Wrangler CLI (`npm install -g wrangler`)

### Steps

1. Clone the repository:
   ```bash
   git clone https://github.com/bhavnicksm/pbnj
   cd pbnj
   npm install
   ```

2. Login to Cloudflare:
   ```bash
   npx wrangler login
   ```

3. Create a D1 database:
   ```bash
   npx wrangler d1 create pbnj-db
   ```

4. Copy the database_id from the output and update wrangler.toml:
   ```toml
   [[d1_databases]]
   binding = "DB"
   database_name = "pbnj-db"
   database_id = "YOUR_DATABASE_ID_HERE"
   ```

5. Run the schema migration:
   ```bash
   npx wrangler d1 execute pbnj-db --remote --file=schema/schema.sql
   ```

6. Set your AUTH_KEY secret:
   ```bash
   npx wrangler secret put AUTH_KEY
   ```
   Enter a secret key when prompted. Save this - you'll need it for the CLI.

7. Build and deploy:
   ```bash
   npm run build
   npx wrangler deploy
   ```

## Custom Domain

To use a custom domain (e.g., paste.yourdomain.com):

1. Go to Cloudflare Dashboard
2. Navigate to Workers & Pages > your worker
3. Go to Settings > Domains & Routes
4. Add your custom domain

## Local Development

1. Copy `.dev.vars.example` to `.dev.vars`
2. Set your AUTH_KEY in `.dev.vars`
3. Run `npm run dev`

The local server will be available at http://localhost:4321

---
Next: 03_cost.md - Cloudflare pricing breakdown