Lytx Kit

Open-source web analytics platform built on RedwoodSDK and Cloudflare Workers.

Structure

• core/ — The lytx library package. Contains all pages, components, API routes, middleware, and Durable Objects for the analytics platform.
• cli/ — CLI tooling (setup wizard, data import scripts).
• create-lytx/ — Draft app scaffolder and starter templates (including Cloudflare starter).

Getting Started

See core/README.md for full documentation on how to integrate Lytx into your Redwood app.

App Scaffolder (Draft)

The monorepo now includes a draft scaffolder package at create-lytx/ with a maintained Cloudflare starter template.

Run locally from this repo:

bun create-lytx/bin/lytx.mjs my-analytics --template cloudflare

Interactive setup + defaults (domains/auth/AI):

bun create-lytx/bin/lytx.mjs my-analytics --template cloudflare --interactive

By default the CLI writes .env from .env.example; add --no-env to skip.

Scaffold and provision in one command:

bun create-lytx/bin/lytx.mjs my-analytics --template cloudflare --provision --stage dev --yes

Planned published usage:

bunx create-lytx my-analytics --template cloudflare
npx create-lytx my-analytics --template cloudflare
npm create lytx@latest my-analytics -- --template cloudflare

Generated projects are aligned with the demo/ setup pattern and include:

• alchemy.run.ts wired to lytx/resource-names
• src/worker.tsx using createLytxApp(...)
• Redwood + Vite starter files plus generated .env and .env.example

After scaffolding:

cd my-analytics
bun install
bun run dev

Package and Command Targets

• Runtime library package name: lytx
• Scaffolder package name: create-lytx
• Scaffolder command entrypoint: create-lytx

Release prep commands (no publish):

bun run lint
bun run ci:oss
bun run pack:all

Governance

• CONTRIBUTING.md
• SECURITY.md
• Pull request template
• Issue templates

Quick Start

cd core
bun install
bun run setup      # Interactive setup wizard
bun run dev        # Start local development

License

MIT — see LICENSE for details.