Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Splint Pixel Studio

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:

Local development

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 dev

Open 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.

Checks

npm.cmd run lint
npm.cmd test
npm.cmd run build
npm.cmd run catalog:build
Set-Location server
npm.cmd run check

The 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.

Repository orientation

  • src/App.jsx and src/components/BottomNavigation.jsx — application shell;
  • src/views/PlayerView.jsx and src/features/coloring/ — painting and tiled player;
  • src/components/CreateHub.jsx and src/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.js and server/services/render-outbox.js — server-authoritative result media;
  • server/db.js and server/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.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages