Deployment

Deployment

The GetSmart Token platform runs on Cloudflare Pages with Edge Workers for serverless functions. Deployments are automated from the main branch on GitHub.

Architecture

Main Site — Cloudflare Pages

The main site (getstoken.org) is a Next.js 15 app compiled for Cloudflare Pages using @cloudflare/next-on-pages.

Build Command

npx @cloudflare/next-on-pages

Environment Variables (Cloudflare Dashboard)

Deployment Flow

1. Push to main on GitHub
2. Cloudflare Pages automatically builds (next build + next-on-pages)
3. Deployment to production completes in ~2 minutes
4. Edge Workers are updated globally via Cloudflare’s network

Important Notes

• NEXT_PUBLIC_* variables must be set in Cloudflare Pages before the build runs — they are inlined at build time
• Edge API routes (e.g. /api/chat) must use getRequestContext() from @cloudflare/next-on-pages to access Cloudflare env bindings at runtime
• The export const runtime = 'edge' declaration is required on all API routes

Help Docs — Netlify

This documentation site is built with Hugo Extended and hosted on Netlify.

Build Command

npm run build   # runs hugo

Local Development

npm install     # installs hugo-extended
npm run serve   # http://localhost:1313

Or with Docker:

docker-compose up

Chatbot Worker

The GetSmart Assistant chatbot runs as a Cloudflare Worker at:

https://getsmart-chatbot.multipleintelligencesuk.workers.dev

It is embedded on the main site via a <script> tag in the layout.

CI/CD

• Cloudflare Pages: automatic deploy on push to main (getsmart-web)
• Netlify: automatic deploy on push to main (gs_help_int)
• Dependabot: weekly dependency updates via PR

Rollback

To roll back Cloudflare Pages to a previous deployment:

1. Go to the Cloudflare Pages dashboard
2. Select the project → Deployments
3. Find the previous successful deployment and click Rollback to this deployment

Submitting Documentation Issues

Submit a new issue to the gs_help_int repo for documentation corrections or improvements.