• ⌨️ Cursor
  • 🔌 Install recommended workspace VSCode extensions.
• 📥 Node.js — version from .node-version.
• 📥 Bun.
• 📝 Fonts:
  • Google Sans Code
  • Cascadia Code
• 🐳 Docker
• 🐘 pgAdmin
• 📱 Android SDK

• ⚙️ !setup.bat: Configure git and install project dependencies.
• ✅ !check.bat: Run all CI checks.
• 🧹 !cleanup.bat: Clean up repository.
• 📦 !upgrade.bat: Upgrade dependencies interactively.
• 🔄 !upgrade_actions.bat: Upgrade GitHub Actions.

Schema source of truth: packages/db-core/prisma/schema.prisma.

1. Run bun do dev.
2. Modify schema.prisma and restart dev server during development.

1. Rebase on main.
2. Run bun do finish-feature.
3. Review changes.
4. Commit if ok.

⚠️ Note: after bun do finish-feature, do not modify schema.prisma. If schema changed, run bun do finish-feature again.

• 📤 Decrypt: bun do decrypt → secrets.prod.yaml
• 🔒 Encrypt: bun do encrypt → writes secrets.prod.enc.yaml (securely save printed key as SECRETS_KEY)

secrets.prod.yaml is temporary; delete it after encrypting.

• Create a dev and prod buckets, access keys and set up access rights.
• Add secrets: S3_ACCESS_KEY, S3_SECRET_KEY, S3_BUCKET.

Dev server (bun do dev) is always at https://home.local (site) and https://home.local/app (app). The machine hostname should be home so phones and other devices on the LAN can resolve home.local. Android debug APK uses the same URL.

• Dev: bun do android-keys-dev
• Prod: bun do decrypt → bun do android-keys-prod → bun do encrypt

1. bun do cert
   • creates $env:USERPROFILE\.snappy\cert\ folder.
2. certutil -addstore -user Root "$env:USERPROFILE\.snappy\cert\ca.pem"
3. bun do dev

On a phone: copy ca.pem to the device and install it as a CA certificate (Settings → Security).

• Hash: MD5
• ResultURL: POST https://snappy-ai.ru/api/webhooks/robokassa
• SuccessURL: GET https://snappy-ai.ru/app/billing/robokassa/success
• FailURL: GET https://snappy-ai.ru/app/billing/robokassa/fail

Server logs go to .logs/ in the repo root (created automatically; gitignored):

• http — Fastify request/access logs (HttpLog)
• payment — top-up, settle, credit, Robokassa webhook / tunnel (Log.payment)
• auth — signup reject / bonus, email send failures (Log.auth)
• ai — LLM proxy gate / debit (Log.ai)

Rotation: daily and at ~20 MB, keep 14 files. For top-up / tunnel issues inspect .logs/payment*.log on the server and locally.

• 🟦 TypeScript
• ⚡ Vite
• 📦 tsdown
• ⚛️ React
• 🔐 Better Auth
• 🧬 Prisma
• 🧪 Vitest
• ✨ ESLint
• 🎨 Prettier
• 🖌️ Stylelint
• 🎯 Lucide
• 📦 Zod
• ✉️ Nodemailer
• 📧 React Email
• 🌐 agent-browser

• GitHub
• PageSpeed Insights
• SSL Labs
• Yandex Webmaster
• Yandex Metrica

• AITunnel panel
• ProxyAPI console

• Reg.ru account
• Reg.ru cloud
• ISPmanager

• VK WorkSpace admin
• VK WorkSpace mail
• Setup guide
• Post master
• Domain security (SPF/DKIM/DMARC)

• Robokassa

• 🎮 MSI Afterburner
• 🦙 Ollama

• 🧠 Hermes Agent — Autonomous agent with memory (GitHub).
• 💻 OpenCode — Open-source coding agent (GitHub).
• 🧪 n0x — The full AI stack in one browser tab (GitHub).
• 🧩 Claude Code — Community research mirror (GitHub).

• AITunnel
• ProxyAPI
• RouterAI
• RockAPI
• GenAPI
• VseLLM
• NeuroAPI
• Aiesa
• Cloud.ru Evolution Foundation Models
• Yandex Cloud Foundation Models
• GigaChat API

• LMSYS Chatbot Arena — blind pairwise comparisons and user-voted Elo ratings.
• Hugging Face Open LLM Leaderboard — open-weight models on standard benchmarks.
• Artificial Analysis — quality, throughput, and price in one place.
• SWE-bench — real-world GitHub-style coding and patching (software engineering).
• LiveBench — frequently updated benchmarks focused on contamination resistance.

• assistant-ui — open-source React toolkit for production AI chat experiences.