Cogniro

Monorepo for the Cogniro project.

Documentation

• Technical documentation - architecture, technology stack, security and authentication, and the persistence and concurrency model.
• Deployment guide - step-by-step setup and run instructions, with and without Docker, including all environment variables.

Structure

cogniro/
├── frontend/   # Next.js web application
├── backend/    # Python (FastAPI) backend

Prerequisites

• Node.js 22
• pnpm 10+
• Python (>=3.14)
• uv (for backend)

Getting started

Install all dependencies (root + frontend) from the project root:

pnpm install

Frontend

pnpm -C frontend dev

See frontend/README.md for details.

Backend

cd backend
uv sync

See backend/README.md for details.

Git hooks

Managed by Husky:

• pre-commit - lint-staged (frontend eslint/prettier + type-check; backend ruff)
• commit-msg - commitlint (conventional commits)
• pre-push - full validation of both projects