knowtis-app CLAUDE.md

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

Knowtis is a real-time collaborative notes platform built as an Nx monorepo with React frontend and NestJS backend. Key technologies: React 19, NestJS 11, PostgreSQL 16, Drizzle ORM, Yjs (CRDT), Socket.io, TanStack Router/Query, Zustand, Tiptap editor.

Important Rules

• Always use pnpm instead of npm or yarn for package management
• No backwards-compatibility hacks — no re-exports from barrel files, no legacy shims, no "old key" comments. If something is renamed or moved, update all consumers. Clean breaks over compat layers.
• Barrels and re-exports — a package's root index.ts is its public API and the only barrel that belongs (Nx enforce-module-boundaries limits consumers to what that file exports): import @knowtis/* and @jovandyaz/* symbols from the package alias, never by deep path. Inside an app or package, import from the file that defines the symbol; don't add index.ts barrels, and if a change would extend one, replace it instead — point its consumers at the source files and delete it (NestJS: barrels breed circular dependencies between modules and providers; Vite: they defeat tree-shaking and slow the dev server). Never re-export a symbol that another package or folder owns.
• Always consult official docs — before implementing or configuring anything involving external tools, libraries, or services (Vercel, Railway, Nx, etc.), AND before debugging library-specific issues (auth flows, init APIs, error codes), fetch the latest official documentation using Context7 MCP, web search, or CLI help. Never assume behavior from memory alone.
• Minimal comments — default to no inline comments. Only write JSDoc on exported APIs, TODO/FIXME markers, or comments that explain a non-obvious WHY (hidden constraint, subtle invariant, framework quirk workaround). Never paraphrase code, never reference the current task/PR/fix in comments.