WeMeditateWeb
This repo builds the WeMeditate site. It uses React, TypeScript, Vike, Tailwind CSS, and
Cloudflare Workers.
Quick start
Prerequisites
- Node.js
22.17.0 (see .node-version)
- pnpm (
npm install -g pnpm)
Setup
- Install dependencies:
pnpm install
- Create your local environment file:
pnpm env:setup
- Add your values to
.env.local. Use .env.example as a reference.
Run locally
pnpm dev
Open http://localhost:5173.
Key commands
| Command | Purpose |
|---|
pnpm dev | Start the local dev server. |
pnpm build | Build the production client and server bundles. |
pnpm preview | Preview the production build locally. |
pnpm prod | Build and run the production server locally with Wrangler. |
pnpm deploy | Build and deploy to Cloudflare. |
pnpm lint | Run ESLint across the codebase. |
pnpm test | Run tests in watch mode. |
pnpm test:run | Run tests once (CI style). |
pnpm test:ui | Open the Vitest UI runner. |
pnpm ladle | Run the component library locally. |
pnpm ladle:build | Build the component library for static hosting. |
pnpm check:wrangler | Validate the design Worker's config offline (run ladle:build first). |
pnpm env:setup | Copy .env.example to .env.local. |
pnpm types:cms | Refresh SahajCloud types from the upstream Payload repo (needs network). |
Project structure
pages/ # Vike pages and routes
components/ # Reusable UI components
layouts/ # Layout wrappers
hooks/ # Shared React hooks
server/ # Backend logic, caching, SahajCloud integration
public/ # Static assets
Working agreements
- Follow the component rules in
DESIGN_SYSTEM.md.
- Use
STORYBOOK.md for component library guidance.
Help and docs
AGENTS.md is the project guide (CLAUDE.md symlinks to it). It maps where everything else
lives, including docs/rules/ (path-scoped rules) and .claude/skills/ (multi-step
procedures).MCP_USAGE.md documents MCP server usage.STORYBOOK.md explains the component documentation flow.
Common issues
- If local config changes have no effect, delete
.env.local and run pnpm env:setup again.
- If
pnpm deploy fails, check your Cloudflare credentials and environment variables.
