Mirror of github.com/Memo-2023/mana-monorepo
Find a file
Till JS 86a01426e8 feat(cards-server): Phase δ.1 — subscriptions + version reads + smart-merge diff
Server-side plumbing for Phase δ. Frontend hookup follows in δ.2.

  - services/subscriptions.ts: subscribe/unsubscribe (idempotent
    upsert on (user, deck), stamps the latest_version_id at
    subscribe-time so the client knows what it pulled). listForUser
    returns each sub with `updateAvailable: currentVersion !== latest`
    so the client can render an update indicator without a second
    round-trip. Refuses paid decks with 403 — that path comes back
    in Phase ζ once the credits Marketplace lands.
  - versionWithCards: deterministic ord-ordered card payload for a
    specific version. Read-public so anonymous browsers can preview
    a deck's content.
  - diffSince: smart-merge payload between any two versions. Splits
    the latest cards into added/changed/unchanged + lists removed
    by content_hash. The 'changed' bucket is heuristic (ord-position
    pair where one was removed and one was added) — solid enough
    until Phase ε's pull-request pipeline gives us real card
    lineage.
  - routes/subscriptions.ts mounts: GET /v1/me/subscriptions,
    POST/DELETE /v1/decks/:slug/subscribe (auth required),
    GET /v1/decks/:slug/versions/:semver (public),
    GET /v1/decks/:slug/diff?from=<semver> (public).

cards-web layout fix:
  - Marketplace surface (/explore, /u/, /d/) was previously gated
    behind the AuthGate — anonymous browsers got pushed to /login
    via client-side navigate. PUBLIC_PATHS extended so those routes
    SSR + render unauthed.

Validated: tsc clean on cards-server, svelte-check 0/0 on cards-web.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-07 19:33:58 +02:00
.changeset feat(versioning): add semantic versioning and changesets to all apps 2026-03-19 16:20:18 +01:00
.claude chore: extract arcade into standalone repo 2026-04-28 22:40:01 +02:00
.github fix(deploy): pnpm install workspace deps before running safe-db-push 2026-04-28 17:10:08 +02:00
.husky chore(hooks): drop --fail-on-warnings from pre-push svelte-check 2026-04-17 02:53:44 +02:00
apps feat(cards-server): Phase δ.1 — subscriptions + version reads + smart-merge diff 2026-05-07 19:33:58 +02:00
docker fix(monitoring): comment-out mana-ai metrics scrape after Phase 2f-3 move 2026-05-07 17:06:04 +02:00
docs docs(infra): Phase 2f added to PLAN_OPTION_C + hostname table updated to v28 2026-05-07 17:09:28 +02:00
infrastructure docs(infra): Phase 2f added to PLAN_OPTION_C + hostname table updated to v28 2026-05-07 17:09:28 +02:00
load-tests refactor: rename zitare -> quotes (Zitate) 2026-04-14 20:59:16 +02:00
NewAppIdeas/Roblox Reimagined chore: complete ManaCore → Mana rename (docs, go modules, plists, images) 2026-04-07 12:26:10 +02:00
packages feat(cards): image / audio attachments on cards via mana-media 2026-05-07 13:52:53 +02:00
patches fix(traces): configure EAS Build for TestFlight and fix bot-services build 2026-03-17 13:16:38 +01:00
scripts feat(personas): move admin + internal endpoints from mana-auth to apps/api 2026-05-06 20:38:29 +02:00
services feat(cards-server): Phase δ.1 — subscriptions + version reads + smart-merge diff 2026-05-07 19:33:58 +02:00
tests feat(personas): M5.a — Playwright visual suite scaffold 2026-04-23 14:33:06 +02:00
.dockerignore make auth working 2025-11-26 01:31:12 +01:00
.editorconfig feat: add monorepo configuration and shared packages structure 2025-11-22 23:41:52 +01:00
.env.development chore(mana-events): move from port 3065 to 3115 — collision with platform mana-media 2026-05-06 20:38:46 +02:00
.env.macmini.example chore(infra): unify prod deploy on .env.macmini + document missing keys 2026-04-23 13:01:29 +02:00
.env.secrets.example feat(env): persistent dev secrets via .env.secrets override 2026-04-08 17:50:37 +02:00
.gitignore infra(gpu-box): commit GPU-Box compose to repo + Phase 2e docs 2026-05-07 13:28:49 +02:00
.npmrc fix(monorepo): add .npmrc with node-linker=hoisted for EAS Build compatibility 2026-03-15 08:50:18 +01:00
.nvmrc feat: add monorepo configuration and shared packages structure 2025-11-22 23:41:52 +01:00
.prettierignore refactor: rename zitare -> quotes (Zitate) 2026-04-14 20:59:16 +02:00
.prettierrc.json fix(cicd): docker paths, formatting config, 2025-11-27 18:33:08 +01:00
CLAUDE.md chore: extract arcade into standalone repo 2026-04-28 22:40:01 +02:00
cloudflared-config.yml feat(gpu-box): mana-ai (AI Mission Runner) migrated, mana-ai.mana.how → GPU tunnel 2026-05-07 16:40:57 +02:00
docker-compose.dev.yml chore(dev): wire SearXNG + mana-search into dev:mana:all 2026-04-15 22:31:29 +02:00
docker-compose.macmini.yml feat(cards-web): Phase β.2 — author onboarding + publish flow 2026-05-07 16:53:17 +02:00
docker-compose.test.yml test(integration): end-to-end auth flow test with Mailpit + CI gating 2026-04-08 17:14:02 +02:00
eslint.config.mjs feat(personas): M2.a-c — persona schemas + admin endpoints + seed pipeline 2026-04-23 13:55:14 +02:00
gift-codes-2026-02-14.txt feat(gifts): add gift code creation script and initial codes 2026-02-14 11:23:08 +01:00
lint-staged.config.js refactor(theming): re-apply theme validator suite after parallel rebase 2026-04-22 17:07:48 +02:00
package.json chore: drop remaining context module legacy refs 2026-04-29 00:20:45 +02:00
playwright.config.ts style: auto-format codebase with Prettier 2025-11-27 18:33:16 +01:00
pnpm-lock.yaml feat(cards-server): Phase α — service skeleton + 16-table schema 2026-05-07 16:01:08 +02:00
pnpm-workspace.yaml chore: extract arcade into standalone repo 2026-04-28 22:40:01 +02:00
README.md refactor: rename zitare -> quotes (Zitate) 2026-04-14 20:59:16 +02:00
SYNC_DEBUG.md docs(sync): add SYNC_DEBUG runbook with new debug API in Schritt C 2026-04-09 17:20:46 +02:00
TROUBLESHOOTING.md refactor: rename zitare -> quotes (Zitate) 2026-04-14 20:59:16 +02:00
turbo.json chore(ci): add v8 test coverage tracking (non-blocking baseline) 2026-04-19 19:21:14 +02:00
vitest.config.ts feat: rename ManaCore to Mana across entire codebase 2026-04-05 20:00:13 +02:00

Mana Monorepo

Monorepo containing all Mana projects — a self-hosted multi-app ecosystem with shared packages and unified tooling.

Projects

Project Description Apps
mana Multi-app ecosystem platform Expo mobile, SvelteKit web
chat AI chat application NestJS backend, Expo mobile, SvelteKit web, Astro landing
todo Task management NestJS backend, SvelteKit web, Astro landing
calendar Calendar & scheduling NestJS backend, SvelteKit web, Astro landing
clock Pomodoro & time tracking NestJS backend, SvelteKit web, Astro landing
contacts Contact management NestJS backend, SvelteKit web
picture AI image generation NestJS backend, Expo mobile, SvelteKit web, Astro landing
cards Card/deck management NestJS backend, Expo mobile, SvelteKit web
quotes Daily inspiration quotes NestJS backend, Expo mobile, SvelteKit web, Astro landing
mukke Music player NestJS backend, SvelteKit web
plants Plant care tracker NestJS backend, SvelteKit web
storage Cloud storage NestJS backend, SvelteKit web
questions Q&A with web search SvelteKit web
skilltree Skill tree visualization NestJS backend, SvelteKit web
food Nutrition tracking NestJS backend, SvelteKit web
citycorners City guide NestJS backend, SvelteKit web, Astro landing
presi Presentation tool NestJS backend, SvelteKit web
photos Photo management NestJS backend, SvelteKit web

Getting Started

Prerequisites

  • Node.js 20+
  • pnpm 9.15.0+
  • Docker (for PostgreSQL, Redis, MinIO)

Installation

pnpm install

Development

# Start infrastructure (PostgreSQL, Redis, MinIO)
pnpm docker:up

# Start any app with auto DB setup
pnpm dev:chat:full
pnpm dev:todo:full
pnpm dev:calendar:full
pnpm dev:contacts:full

# Build & quality
pnpm run build
pnpm run type-check
pnpm run format

See CLAUDE.md for comprehensive development documentation.

Architecture

mana-monorepo/
├── apps/                    # Product applications
├── services/                # Microservices (auth, search, LLM, bots)
├── packages/                # Shared packages
├── docker/                  # Docker configuration
└── scripts/                 # Development & deployment scripts

Tooling

  • Package Manager: pnpm 9.15.0
  • Build System: Turborepo
  • Formatting: Prettier (tabs, single quotes, 100 char width)
  • Hosting: Mac Mini (self-hosted) via Docker + Cloudflare Tunnel
  • Analytics: Umami (stats.mana.how)

License

Private - All rights reserved