Go to file
saravanakumardb1 bb6d77b1a4 refactor(mobile): DRY getAccessToken into shared auth-helpers.ts
Extract the duplicated getAccessToken() function from platform.ts,
billing-client.ts, and platform-api.ts into a single auth-helpers.ts.
All three now import from the shared module.
2026-04-13 11:06:22 -07:00
.gitea/workflows ci: fix YAML formatting — normalize blank lines 2026-03-29 11:04:16 -07:00
.github feat: integrate feedback, broadcast, survey, offline-queue clients + settings page + devops 2026-03-29 20:57:27 -07:00
.husky chore: add Husky pre-commit hooks + secret-scan scripts 2026-03-27 23:07:30 -07:00
backend feat(backend): wire @bytelyst/webhook-dispatch to domain event bus 2026-04-13 10:29:43 -07:00
docs docs(palace): update roadmap — mark all phases complete with commit hashes + test counts 2026-04-10 10:22:42 -07:00
mobile refactor(mobile): DRY getAccessToken into shared auth-helpers.ts 2026-04-13 11:06:22 -07:00
scripts chore(devops): add LLM env vars to .env.example, docker-compose, docker-prep 2026-04-06 11:15:36 -07:00
shared fix: normalize product.json + replace --ml-* with --nl-* CSS namespace 2026-03-21 20:20:40 -07:00
web feat(web,mobile): add @bytelyst/billing-client and platform-client 2026-04-13 10:30:02 -07:00
.aider.conf.yml chore(docs): regenerate AI agent config files 2026-03-10 22:56:39 -07:00
.clinerules chore(docs): regenerate AI agent config files 2026-03-10 22:56:39 -07:00
.cursorrules chore(docs): regenerate AI agent config files 2026-03-10 22:56:39 -07:00
.dockerignore feat(repo): migrate notelett workspace to pnpm 2026-03-22 15:50:54 -07:00
.editorconfig chore(docs): regenerate AI agent config files 2026-03-10 22:56:39 -07:00
.gitignore fix(repo): restore web lint and ignore generated artifacts 2026-03-10 10:30:49 -07:00
.npmrc chore: add common-plat workspace link and switch to localhost Gitea 2026-04-13 10:29:23 -07:00
.npmrc.docker feat(docker): migrate NoteLett to Gitea registry-backed Docker pattern 2026-03-23 20:11:12 -07:00
.nvmrc chore: add .nvmrc pinning Node 22 2026-03-29 10:48:30 -07:00
.windsurfrules chore(docs): regenerate AI agent config files 2026-03-10 22:56:39 -07:00
AGENTS.md docs: update AGENTS.md test counts and SMART_ACTIONS_ROADMAP Phase 6 status (G20) 2026-04-06 13:44:41 -07:00
CLAUDE.md feat(repo): migrate notelett workspace to pnpm 2026-03-22 15:50:54 -07:00
docker-compose.yml chore(devops): add LLM env vars to .env.example, docker-compose, docker-prep 2026-04-06 11:15:36 -07:00
package.json chore: add Husky pre-commit hooks + secret-scan scripts 2026-03-27 23:07:30 -07:00
pnpm-lock.yaml chore: add common-plat workspace link and switch to localhost Gitea 2026-04-13 10:29:23 -07:00
pnpm-workspace.yaml chore: add common-plat workspace link and switch to localhost Gitea 2026-04-13 10:29:23 -07:00
README.md docs: align AGENTS.md and README.md with Smart Actions implementation 2026-04-06 11:17:08 -07:00

NoteLett

Structured notes platform for humans and AI agents — part of the ByteLyst ecosystem.

Quick Start

pnpm install

# Backend (port 4016)
pnpm --filter @notelett/backend run dev

# Web (port 3000)
pnpm --filter @notelett/web run dev

# Mobile
pnpm --filter @notelett/mobile run start

Architecture

Surface Stack Port
Backend Fastify 5 + TypeScript ESM 4016
Web Next.js 16 + React 19 3000
Mobile Expo + React Native 8081
Platform platform-service (shared) 4003
Extraction extraction-service (shared) 4005

Key Features

  • 8 backend modules: notes, workspaces, relationships, tasks, artifacts, agent actions, saved views, note-prompts (Smart Actions)
  • 8 MCP tools: list, get, search, create_draft, update, link_notes, extract_tasks, attach_artifact
  • Smart Actions: 20 built-in prompt templates, copilot text transforms, scheduler, webhooks, URL extraction
  • Agent audit trail: every write tool records agent action history
  • Datastore abstraction: Cosmos DB in production, in-memory for tests
  • Platform integrations: auth (JWT), telemetry, diagnostics, feature flags, kill-switch, blob storage
  • LLM integration: @bytelyst/llm with retry, timeout, and fallback heuristics

Environment

Copy backend/.env.example to backend/.env and fill in:

  • JWT_SECRET — shared secret with platform-service
  • COSMOS_ENDPOINT / COSMOS_KEY — Azure Cosmos DB credentials (or use DB_PROVIDER=memory)
  • LLM_PROVIDERmock, openai, or azure (default: mock)
  • OPENAI_API_KEY — required if LLM_PROVIDER=openai

Tests

pnpm --filter @notelett/backend run test
pnpm --filter @notelett/web run test
pnpm --filter @notelett/mobile run test
pnpm run verify

Docs