dario-publish

A package for publishing functionality in the Dario Tools monorepo.

Setup

Cloudflare API Token

To use this package, you need a Cloudflare API token with permissions to manage Cloudflare Pages.

Required Permissions:

• Account → Cloudflare Pages → Edit (or Write)

This permission allows the token to:

• Read existing Pages projects
• Create new Pages projects
• Create deployments
• Check deployment status
• Upload files to deployments

Steps to create the token:

1. Go to Cloudflare API Tokens
2. Click "Create Token"
3. Choose one of these options:
   • Option A (Recommended): Use the "Edit Cloudflare Workers" template (includes Pages permissions)
   • Option B: Create a Custom Token with:
     • Account → Cloudflare Pages → Edit
4. Set Account Resources to your account
5. Click "Continue to summary" → "Create Token"
6. Copy the token immediately (it's only shown once)

Cloudflare Account ID

Your Account ID can be found:

• In the Cloudflare dashboard URL: https://dash.cloudflare.com/{account_id}/...
• Or go to Cloudflare Dashboard → select your account → the ID is in the sidebar

Environment Variables

Set these environment variables:

• CLOUDFLARE_TOKEN - Your Cloudflare API token
• CLOUDFLARE_ACCOUNT_ID - Your Cloudflare account ID
• PUBLISH_API_KEY - API key for the publish endpoint
• PLATFORM_API_URL - (Optional) Platform API URL (defaults to http://localhost:3000/api)

Development

# Build the package
pnpm build

# Watch mode
pnpm dev

# Type check
pnpm typecheck