Skip to content
RecranetFlare

Getting started

You need Node 24.21 or later, pnpm, and an npm login with access to the Recranet org: Flare and Verano are restricted packages.

Terminal window
npm login

Create an app

Section titled “Create an app”
Terminal window
pnpm dlx @recranet/flare create my-app
cd my-app

This copies the Verano starter: a Void app with Verano’s Vue components, in a console-style shell with an organization switcher. Sign-in and sign-up, organizations with roles from access, invitations, English and Dutch through i18n, and tasks as the example resource: a list, a detail page and a JSON API. It writes a random BETTER_AUTH_SECRET to .env.

For a JSON API without pages, add --starter api. See the flare command for the flags.

Install and migrate

Section titled “Install and migrate”
Terminal window
pnpm install
pnpm db:migrate

db:migrate runs void db migrate against the local D1 database.

Run it

Section titled “Run it”
Terminal window
pnpm dev

Deploy

Section titled “Deploy”
Terminal window
pnpm deploy

This runs void deploy, which creates the D1 database and the other resources it finds in your code on your Cloudflare account.

Add plugins

Section titled “Add plugins”

Each plugin is a subpath of @recranet/flare, e.g. @recranet/flare/audit. Its guide lists the files it touches in your app. Start with access; most others build on it.