Combined marketing site and consulting platform (SimpleRMS) for Akritos Technology Partners, LLC — Apple device management and AI risk consulting for small businesses.
Public site:https://akritos.com
- What's public (this repo): the application code, technical architecture, decisions log, lessons log, framework practices, deployment guidance
- What's not public: strategic growth playbook, pricing experiments, customer artifacts, internal hiring plans
The platform code is open source because the brand is built on transparency. Business strategy is not, because that's competitive.
- Next.js 16 (App Router) · PostgreSQL 16 · Prisma 6
- Auth.js v5 · tRPC v11 · Tailwind 4
- Stripe (Payment Links + webhooks) · Nodemailer (SMTP)
- Docker Compose · DreamCompute VPS · Nginx · Let's Encrypt
| File | Purpose |
|---|---|
CLAUDE.md | Operating constraints + project context. Read first. |
docs/FRAMEWORK.md | The disciplines that prevent prompt jockeying. |
docs/ARCHITECTURE.md | Stack, structure, design patterns. |
docs/DECISIONS.md | Append-only architectural decisions with rationale. |
docs/LESSONS.md | Append-only small lessons from sessions. |
docs/ROADMAP.md | Build status (what works, what's queued). |
docs/features/*.md | Per-feature specs. |
DREAMHOST.md | VPS deployment guide. |
SECURITY.md | Vulnerability reporting policy. |
npm install
docker compose up -d db mailpit
npx prisma db push
npx prisma db seed
npm run devSign in at http://localhost:3000/login. The seed creates an admin account; the password is generated and printed once during the seed run.
ssh your-vps
cd /opt/simplerms && git pull && bash deploy.shThe deploy script handles: build, schema push, idempotent seed, health-check, container swap, nginx config, Let's Encrypt cert. Blog post seeds in prisma/seed-blog-*.ts are idempotent and run on every deploy.
See SECURITY.md. CI runs Dependabot, CodeQL, Semgrep, gitleaks, and npm audit on every push and PR.
MIT.