Qalam
Qalam is a LinkedIn writing and publishing system with voice memory, approvals, analytics, and multi-client agency workflows. The product is Qalam; byqalam.com is the domain.
Project rules for AI coding tools live in CLAUDE.md and AGENTS.md. Read them before changing code.
Stack
- Next.js 16 App Router, React 19, TypeScript, Tailwind CSS v4 (
app/globals.css)
- Auth: NextAuth v5 (credentials and LinkedIn sign-in)
- Data: Supabase Postgres with RLS, migrations in
supabase/migrations
- Jobs and limits: Upstash Redis, QStash, Vercel Cron (
vercel.json)
- AI: Groq, Gemini, Cerebras, OpenRouter behind a daily spend cap
- Payments: Lemon Squeezy (USD store)
- Email: Resend
- Monitoring: Sentry
- Browser extension:
extension/
Getting started
npm install # also installs the git hooks
cp .env.example .env.local
npm run dev
Fill .env.local from .env.example. Without Supabase, AI, and LinkedIn credentials, the marketing site renders but app features will fail.
Scripts
| Command | Purpose |
|---|
npm run dev | Local dev server |
npm run build | Production build. prebuild blocks the build if any local migration is not applied to the configured database |
npm run typecheck | Regenerates route types, then runs tsc |
npm run lint | ESLint |
npm test | Vitest unit and integration tests (__tests__/) |
npx playwright test | Browser tests (tests/) |
npm run check:dashes | Blocks em and en dashes (also runs as a pre-commit hook) |
npm run check:rls | Audits database RLS policies and grants |
npm run check:migrations | Verifies every local migration is applied |
npm run eval:prompts | Prompt contract evals |
Repo map
| Path | What lives there |
|---|
app/ | Marketing pages, SEO landing pages, free tools, legal, blog |
app/(app)/ | Signed-in app: writer, library, calendar, analytics, approvals, voice, carousels, career, agency, desk, passport |
app/connect, app/drop, app/proof, app/pitch | Client-facing token pages for agencies (no Qalam account needed) |
app/api/ | Route handlers, including webhooks and cron jobs |
app/admin/ | Platform admin area |
components/ | Shared UI, app shell, agency components |
lib/ | Business logic, prompts, pricing, SEO content |
lib/server/ | Server-only helpers: auth, workspace, LinkedIn, payments, Supabase, agency |
proxy.ts | Host routing, route protection, security headers |
supabase/migrations/ | Database schema history |
docs/ | Product, positioning, design, and audit documents |
scripts/ | Readiness checks, git hooks, evals |
Sources of truth
| Concern | File |
|---|
| Plans, prices, plan features | lib/pricing.ts |
| Career add-on catalog | lib/career-pricing.ts |
| Product and use-case copy | lib/site-content.ts |
| SEO constants and route inventory | lib/seo.ts |
| Global metadata and JSON-LD | app/layout.tsx |
| Protected app routes | lib/protected-routes.ts |
| Domain types | types/domain.ts |
Product truth rules
- Never fake customer logos, ratings, analytics, or integrations.
- Any claim about memory, learning, or analytics must be backed by code that does it. If it is not, downgrade the wording.
- Prices on the site must match what Lemon Squeezy actually charges.
