cuibonobo.com

I want an SSG that routes to real HTML pages and doesn't load JavaScript unless it's necessary. Is that so much to ask?

Running locally

npm install
npm run build
npm run dev

Development

# Run type-checking and formatting
npm run check

# Fix lint errors
npm run lint:fix

# Run tests
npm run test

CLI

This tool allows interaction with the stack without having to manually update files and databases or generate IDs. By default the CLI will interact with the local Cloudflare development environment, but it's possible to interact with the production Cloudflare instance by adding an --omit=dev flag.

Available resource types: article, note, page

# Create a new resource and start editing it
npm run cli -- new <resourceType>

# Commit the currently-edited resource to the datastore
npm run cli -- commit

# List existing resources
npm run cli -- list <resourceType>

# Read an existing resource
npm run cli -- read <resourceID>

# Edit an existing resource
npm run cli -- edit <resourceID>

# Discard the current edit
npm run cli -- discard

# Check if there are resources being edited
npm run cli -- status

# Generate a slug for the given text
npm run cli -- slugify <quotedText>

Setup

FIXME: These instructions do not include how to download existing media

1. Create an .env file and a .dev.vars file with API_TOKEN=<token> if needed for any other services.

2. Create a Cloudflare API token in the Cloudflare dashboard. Recommended scopes: minimal permissions for Workers and D1 (or the specific services you need).

   • In Cloudflare: My Profile → API Tokens → Create Token → choose a template or custom policy with least privilege.

3. On your host machine (before opening the devcontainer) export the token so VS Code can forward it into the container:

export CLOUDFLARE_API_TOKEN="your_token_here"

4. Reopen or rebuild the devcontainer in VS Code so the CLOUDFLARE_API_TOKEN is injected into the container.

5. The devcontainer will automatically install wrangler on first create. After the container is ready, verify authentication:

bash .devcontainer/wrangler-setup.sh

6. Now that wrangler is authenticated, initialize the database if needed:

# Download the existing remote database to a file
npx wrangler d1 export stack_db --remote --output=./database.sql

# Initialize the local database with the downloaded data
npx wrangler d1 execute stack_db --local --file=database.sql

7. Run npm run dev to run a local server, and then run npm run build to build the pages. The home page on the dev server will throw a 404 error until the pages are built!

8. Visit http://localhost:8788/ in a browser to navigate to the site

Building on Cloudflare Pages

Build Configuration

• Build command: npm run build
• Build output directory: build

Environment Variables

• NODE_ENV: production
• NODE_VERSION: 18
• TZ: America/New_York
• API_TOKEN: <secret>