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

1. Install dependencies: pnpm install
2. Create your local environment file: pnpm env:setup
3. 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.