[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_118":119},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module not found","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":34,"_35":26,"_36":37,"_38":-5,"_39":-5,"_40":41,"_42":43,"_44":45,"_46":47,"_48":49,"_50":51,"_52":53,"_54":55,"_56":-5,"_57":49,"_58":59,"_60":61,"_62":63,"_64":65,"_66":67,"_68":69,"_70":71,"_72":73,"_74":75,"_76":77,"_78":79,"_80":-5,"_81":-5,"_82":-5,"_83":49,"_84":-5,"_85":86,"_87":88,"_89":90,"_91":92,"_93":94,"_95":96,"_97":98},"apiUrl","https://odel.app/api","creator","jovandyaz","moduleId","knowtis-app","@jovandyaz/knowtis-app","displayName","Knowtis","tagline","Create, search and manage Knowtis collaborative notes from AI assistants.","iconKey","https://knowtis.app/apple-touch-icon.png","category","remote","status","published","visibility","public","metaDescription","deploymentType","external","workerName","bindingName","mcpConfig","{\"url\":\"https://mcp.knowtis.app/mcp\",\"transport\":\"streamable-http\",\"authType\":\"none\"}","pricingModel","free","creatorUserId","system:external-import","createdAt",1783743482000,"updatedAt",1788322770000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=app.knowtis%2Fknowtis","sourceVerified",false,"sourceMissingSince","importedAt","upstreamStars",3,"upstreamUpdatedAt",1788310979000,"detectedTransport","streamable-http","detectedAuthType","oauth","probeStatus","ok","lastProbedAt",1787631545000,"githubRepoUrl","https://github.com/jovandyaz/knowtis-app","githubRepoFullName","jovandyaz/knowtis-app","releaseId","ext-jovandyaz-knowtis-app","version","0.1.0","descriptionMarkdown","# Knowtis\n\n

\n $\"MIT$ \n $\"GitHub$ \n $\"GitHub$ \n $\"CI$ \n

\n\n

\n $\"Nx\"$ \n $\"React\"$ \n $\"NestJS\"$ \n $\"TypeScript\"$ \n $\"PostgreSQL\"$ \n

\n\n

\n AI-powered collaborative notes platform — your notes are your knowledge base\n

\n\n---\n\n## Table of Contents\n\n- [Overview](#overview)\n- [Quick Start](#quick-start)\n- [Project Structure](#project-structure)\n- [Running the Project](#running-the-project)\n- [Available Scripts](#available-scripts)\n- [Architecture](#architecture)\n- [Development](#development)\n- [Documentation](#documentation)\n- [Contributing](#contributing)\n- [License](#license)\n\n---\n\n## Overview\n\n**Knowtis** is an AI-powered collaborative workspace that turns your notes into a knowledge base:\n\n- 🤖 **AI Assistant** - Improve writing, fix spelling, summarize, translate, and expand content with inline AI actions\n- 💬 **AI Copilot** - Conversational assistant that reads and edits your notes with approval (HITL), with per-conversation model selection and bring-your-own-key (BYOK) billing\n- 🧠 **Study Tools** - Auto-generate flashcards, quizzes, summaries, and mind maps from your notes\n- 🃏 **Spaced Repetition** - SM2 algorithm for optimal flashcard review scheduling\n- 📝 **Rich Text Editing** - Tiptap/ProseMirror with slash commands, ghost text suggestions, and AI blocks\n- 🔄 **Real-time Collaboration** - CRDT-based sync using Yjs with live presence and remote cursors\n- 🎙️ **Voice Notes** - Record and transcribe voice notes with AI processing\n- 🌐 **Offline Support** - IndexedDB persistence with optimistic local-first updates\n- 🔐 **Secure Authentication** - JWT-based auth with HttpOnly cookie refresh tokens\n- 🌍 **Internationalization** - Full i18n support (English and Spanish)\n- 🔌 **MCP Integration** - Model Context Protocol server for AI assistant workflows\n- 🛠️ **Admin Backoffice** - Ops surface for users, feature flags, runtime AI config, and AI metrics\n- 🎨 **Modern UI** - Tailwind CSS 4 with dark mode, resizable panels, and responsive design\n\n---\n\n## Quick Start\n\n### Prerequisites\n\n| Requirement | Version |\n| ----------- | ------- |\n| Node.js | ≥ 22.x |\n| pnpm | ≥ 10.x |\n| Docker | ≥ 20.x |\n\n### Setup\n\n```bash\ngit clone git@github.com:jovandyaz/knowtis_app.git\ncd knowtis_app\npnpm setup # installs deps, scaffolds .env files, starts Docker, pushes the schema\npnpm setup:agents # installs the project-scoped Claude Code plugins (optional)\npnpm dev:all # starts the API + Notes + Backoffice\n```\n\n> `pnpm setup` is idempotent — it never overwrites an existing `.env`. AI features (`/api/ai/*`) need an `ANTHROPIC_API_KEY` or `OPENAI_API_KEY` in `apps/api/.env` after the first run.\n\nDesign-system tokens are regenerated automatically before the app starts (the `serve`/`build` targets depend on `design-system:build`), so `pnpm dev:all` works on a fresh clone with no extra step.\n\nTo run apps individually instead:\n\n```bash\npnpm dev # Notes only (http://localhost:4200)\npnpm dev:backoffice # Backoffice only (http://localhost:4400)\npnpm dev:api # Backend only (http://localhost:3333)\npnpm dev:mcp # MCP server only (http://localhost:3334)\n```\n\n> New here? [docs/LOCAL_SETUP.md](https://github.com/jovandyaz/knowtis-app/blob/main/docs/LOCAL_SETUP.md) is the full onboarding guide — verified boot sequence, how email verification works in local dev (the code is logged, not mailed), and how to connect an MCP client (Claude Desktop, Cursor, VS Code) to your local notes.\n\n### Access Points\n\n| Service | URL |\n| ---------- | ------------------------------ |\n| Frontend | |\n| Backoffice | |\n| API | |\n| WebSocket | ws://localhost:3333 |\n| DB Studio | Run `pnpm db:studio` |\n\n---\n\n## Running the Project\n\n### Development Mode\n\n#### Full Stack (Recommended)\n\n```bash\n# Start all services\npnpm docker:up # Database + Redis\npnpm dev:all # API + Notes + Backoffice\n```\n\n#### Frontend Only\n\n```bash\npnpm dev\n```\n\n> **Note:** When running frontend-only, collaboration will use WebRTC P2P mode (no backend required).\n\n#### API Only\n\n```bash\npnpm docker:up\npnpm dev:api\n```\n\n### Production Build\n\n```bash\n# Build all projects\npnpm build # Frontend → dist/apps/notes\npnpm build:api # Backend → dist/apps/api\n\n# Run production API\nnode dist/apps/api/main.js\n\n# Preview production frontend\npnpm preview\n```\n\n### Running Tests\n\n```bash\npnpm test # Run all tests\npnpm test:run # Run tests once (no watch)\npnpm test:coverage # Run with coverage report\nnx test notes # Test specific project\nnx test api # Test API project\n```\n\n---\n\n## Available Scripts\n\n### Development\n\n| Command | Description |\n| --------------------- | --------------------------------------- |\n| `pnpm dev` | Start Notes frontend (Vite) |\n| `pnpm dev:api` | Start API backend (NestJS) |\n| `pnpm dev:backoffice` | Start Backoffice frontend (Vite) |\n| `pnpm dev:all` | Start Notes + Backoffice + API together |\n\n### Build & Preview\n\n| Command | Description |\n| ----------------------- | ------------------------------- |\n| `pnpm build` | Build Notes for production |\n| `pnpm build:backoffice` | Build Backoffice for production |\n| `pnpm build:api` | Build API for production |\n| `pnpm preview` | Preview production build |\n\n### Testing & Quality\n\n| Command | Description |\n| -------------------- | ---------------------------- |\n| `pnpm test` | Run all tests in watch mode |\n| `pnpm test:run` | Run all tests once |\n| `pnpm test:coverage` | Run tests with coverage |\n| `pnpm lint` | Run ESLint on all projects |\n| `pnpm lint:fix` | Fix auto-fixable lint issues |\n| `pnpm format` | Format code with Prettier |\n| `pnpm typecheck` | Run TypeScript type checking |\n\n### Database\n\n| Command | Description |\n| ------------------ | --------------------------------- |\n| `pnpm db:push` | Push schema changes (development) |\n| `pnpm db:generate` | Generate migration files |\n| `pnpm db:migrate` | Run database migrations |\n| `pnpm db:studio` | Open Drizzle Studio GUI |\n\n### Infrastructure\n\n| Command | Description |\n| ------------------ | -------------------------- |\n| `pnpm docker:up` | Start PostgreSQL + Redis |\n| `pnpm docker:down` | Stop and remove containers |\n\n### Nx Workspace\n\n| Command | Description |\n| --------------------- | ---------------------------- |\n| `pnpm graph` | Visualize dependency graph |\n| `pnpm affected:test` | Test only affected projects |\n| `pnpm affected:lint` | Lint only affected projects |\n| `pnpm affected:build` | Build only affected projects |\n| `nx serve ` | Serve specific project |\n| `nx build ` | Build specific project |\n| `nx test ` | Test specific project |\n\n### Makefile (Alternative)\n\nFor convenience, all commands are also available via `make`:\n\n```bash\n# Show all available commands\nmake help\n\n# Quick workflows\nmake setup # Full setup: install, docker, db\nmake start # Start DB + all apps\nmake fresh # Clean install from scratch\nmake ci # Run full CI pipeline locally\n\n# Common commands\nmake dev # Start Notes frontend\nmake dev-api # Start backend\nmake dev-backoffice # Start Backoffice frontend\nmake dev-all # Start everything\nmake test # Run tests\nmake lint # Lint code\nmake build # Build for production\n```\n\nRun `make help` to see all available targets with descriptions.\n\n---\n\n## Architecture\n\n### Tech Stack\n\n| Layer | Technology |\n| --------- | ------------------------------------- |\n| Frontend | React 19, Vite, TanStack Router/Query |\n| Backend | NestJS 11, Drizzle ORM |\n| Database | PostgreSQL 16, Redis 7 |\n| AI | Claude API (Sonnet 4, Haiku 4.5) |\n| Real-time | Socket.io, Yjs (CRDT) |\n| Email | React Email, Resend |\n| Styling | Tailwind CSS 4 |\n| i18n | react-i18next |\n| Testing | Vitest, React Testing Library |\n| Monorepo | Nx 22.3 |\n\n### Dependency Flow\n\nThe workspace follows a unidirectional dependency flow:\n\n```mermaid\ngraph TD\n subgraph Apps\n Notes[apps/notes]\n Backoffice[apps/backoffice]\n API[apps/api]\n end\n\n subgraph Libs\n ApiClient[libs/api-client]\n DataAccess[libs/data-access]\n Authorization[libs/authorization]\n end\n\n subgraph SharedPackages\n DesignSystem[packages/design-system]\n Shared[packages/shared]\n end\n\n Notes --> ApiClient\n Notes --> DataAccess\n Notes --> DesignSystem\n Backoffice --> DataAccess\n Backoffice --> DesignSystem\n ApiClient --> Shared\n DataAccess --> ApiClient\n DataAccess --> Shared\n DesignSystem --> Shared\n\n subgraph Packages\n Email[packages/email]\n EmailNestjs[packages/email-nestjs]\n Auth[packages/auth]\n AuthNestjs[packages/auth-nestjs]\n end\n\n API --> EmailNestjs\n API --> AuthNestjs\n EmailNestjs --> Email\n EmailNestjs --> AuthNestjs\n AuthNestjs --> Auth\n```\n\n### Key Design Principles\n\n- **SOLID Principles** - Clean, maintainable architecture\n- **Domain-Driven Design** - Clear separation of concerns\n- **Type Safety** - Strict TypeScript throughout\n- **Composition over Inheritance** - Flexible component design\n\nFor detailed architecture documentation, see [docs/ARCHITECTURE.md](https://github.com/jovandyaz/knowtis-app/blob/main/docs/ARCHITECTURE.md).\n\n---\n\n## Development\n\n### Environment Variables\n\n#### API (`apps/api/.env`)\n\n```env\n# Database\nDATABASE_URL=postgresql://knowtis:knowtis_dev@localhost:5432/knowtis\n\n# Authentication\nJWT_SECRET=your-jwt-secret-key\nJWT_REFRESH_SECRET=your-refresh-secret-key\nJWT_EXPIRES_IN=15m\nJWT_REFRESH_EXPIRES_IN=7d\n\n# Server\nPORT=3333\nNODE_ENV=development\nFRONTEND_URL=http://localhost:4200\n```\n\n#### Notes App (`apps/notes/.env`)\n\n```env\n# API Configuration\nVITE_API_URL=http://localhost:3333/api/v1\nVITE_WS_URL=http://localhost:3333\n\n# Collaboration Mode: 'webrtc' | 'websocket' | 'hybrid'\nVITE_COLLABORATION_MODE=websocket\n```\n\n### Code Quality\n\nThis project uses:\n\n- **ESLint** - Code linting with modern flat config\n- **Prettier** - Code formatting\n- **Lefthook** - Git hooks (pre-commit, pre-push, commit-msg)\n\n### IDE Setup\n\nRecommended VS Code extensions:\n\n- ESLint\n- Prettier\n- Tailwind CSS IntelliSense\n- Nx Console\n\n---\n\n## Documentation\n\n| Document | Description |\n| ------------------------------------------------- | ----------------------------------------- |\n| [API Documentation](https://github.com/jovandyaz/knowtis-app/blob/main/apps/api/README.md) | Backend API setup, endpoints & deployment |\n| [Notes App Documentation](https://github.com/jovandyaz/knowtis-app/blob/main/apps/notes/README.md) | Frontend features & architecture |\n| [Architecture Guide](https://github.com/jovandyaz/knowtis-app/blob/main/docs/ARCHITECTURE.md) | System design & principles |\n| [Deployment Guide](https://github.com/jovandyaz/knowtis-app/blob/main/docs/DEPLOYMENT.md) | Railway & Vercel deployment |\n| [API Architecture](https://github.com/jovandyaz/knowtis-app/blob/main/apps/api/ARCHITECTURE.md) | Backend DDD patterns & module structure |\n| [AI Module](https://github.com/jovandyaz/knowtis-app/blob/main/docs/AI.md) | Copilot, model selection, BYOK & AI flows |\n| [Email Templates](https://github.com/jovandyaz/knowtis-app/blob/main/packages/email/README.md) | React Email templates & i18n |\n| [Email NestJS](https://github.com/jovandyaz/knowtis-app/blob/main/packages/email-nestjs/README.md) | NestJS email module (Resend/Console) |\n| [Contributing Guide](https://github.com/jovandyaz/knowtis-app/blob/main/CONTRIBUTING.md) | How to contribute to the project |\n| [Security Policy](https://github.com/jovandyaz/knowtis-app/blob/main/SECURITY.md) | Vulnerability reporting & disclosure |\n\n---\n\n## Contributing\n\nWe welcome contributions! Please see [CONTRIBUTING.md](https://github.com/jovandyaz/knowtis-app/blob/main/CONTRIBUTING.md) for guidelines on how to get started.\n\n---\n\n## License\n\nLicensed under the [MIT License](https://github.com/jovandyaz/knowtis-app/blob/main/LICENSE).\n\n---\n\n

\n Built with ❤️ using Nx, React, and NestJS\n

\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays",0,"iconType","image","upstream",{"_101":102,"_103":104,"_105":106,"_107":108,"_109":110,"_111":112},"requiredSecrets",[],"tags",[],"assets",[],"stats",{"_99":86,"_100":86},"ratingAvg","reviewCount","topics",[],"license","MIT","language","TypeScript","registryName","app.knowtis/knowtis","homepage","https://knowtis.app","packages",[113],{"_114":115,"_116":117,"_76":-5},"registryType","mcpb","identifier","https://github.com/jovandyaz/knowtis-app/releases/download/mcp-v0.1.0/knowtis-mcp-0.1.0.mcpb","ENV",{"_120":121,"_122":123,"_124":125},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]