Playground

This repository contains the source code for https://playground.hello.dev/.

Getting Started

Prerequisites

1. Git
2. Node.js (version 18 or higher)
3. A fork of this repository (required for contributions)
4. A local clone of the Playground repository
5. A Hellō account (Create one at Hellō Wallet)
6. A client_id for a Hellō application with http://localhost:* development redirect URI enabled (Create one at the Hellō Developer Console)

Installation

1. Run cd playground to navigate to the project root
2. Run npm i to install the necessary npm dependencies

Running Locally

1. Run npm run dev to start the hot-reloading development server (powered by Vite)
2. Open http://localhost:5173 in your preferred browser
3. Use your application's client_id and update the value in the Protocol Parameters section
4. Update the redirect_uri in the Protocol Parameters section to be http://localhost:5173

License

This project is licensed under the MIT License.

Deployment

playground.hello.dev is served from Cloudflare Workers as static assets (see wrangler.toml).

• npm run build writes the site to dist/.
• worker/index.js proxies POST /api/event to Plausible; every other path is a static asset.
• Merging a PR into main requires the Ready for merge check (build + tests) and the Cloudflare Workers preview build to pass.
• Cloudflare Workers Builds watches main and deploys on merge. Nothing deploys from GitHub Actions.
• public/_headers sets the CSP and is copied into dist/ by the build.
• npm run deploy deploys by hand with your own Cloudflare login. Normally unnecessary.