Splint Pixel Studio is a Telegram Mini App for painting, creating, collecting,
and discovering visual works. Painting is the primary action; the stable
product shell is Каталог / Создать / Профиль.
The same shell is responsive in an ordinary browser, but authenticated
production use currently returns to the Telegram Mini App. The standalone
browser shows a handoff to the existing production bot
@splint_pixel_studio_bot; it does not create a browser-only account or
advertise the dormant OIDC flow. See
docs/RESPONSIVE_WEB_AND_TELEGRAM_IDENTITY.md.
Project documentation:
- Operating contract: AGENTS.md
- Documentation map: docs/INDEX.md
- Current operational truth: docs/CURRENT_STATE.md
Requirements: Node.js 20 or newer and npm.
Install dependencies in the root and server directories:
npm.cmd install
Set-Location server
npm.cmd install
Set-Location ..Start the API in one terminal and the Vite client in another:
npm.cmd run dev:api
npm.cmd run devOpen http://127.0.0.1:5173. Local development uses the existing SQLite
fallback unless DATABASE_URL is configured. See DEVELOPMENT.md
for environment setup, ports, QA flags, and troubleshooting.
npm.cmd run lint
npm.cmd test
npm.cmd run build
npm.cmd run catalog:build
Set-Location server
npm.cmd run checkThe authoritative CI workflow also runs the server suite, PostgreSQL checks, storage checks, and the critical/extended Playwright topology described in docs/E2E_TEST_INVENTORY.md.
src/App.jsxandsrc/components/BottomNavigation.jsx— application shell;src/views/PlayerView.jsxandsrc/features/coloring/— painting and tiled player;src/components/CreateHub.jsxandsrc/views/CreatorView.jsx— import-first creator;src/views/ProfileView.jsx— creator/collector showcase;server/routes/colorings.js— catalog, uploads, progress, and completion;server/services/canonical-renderer.jsandserver/services/render-outbox.js— server-authoritative result media;server/db.jsandserver/migrations/— SQLite/PostgreSQL persistence;server/catalog-templates.json— built-in catalog templates.
Production deployment, current blockers, content approval, and commerce activation are deliberately not asserted here. Read the documentation map and current-state document for those decisions. Telegram Stars purchase access, marketplace settlement, and payouts remain separate operational decisions.