Organized Glitter is a coloring book and diamond art tracker. This repository contains the complete website, including the tracker, Astro updates blog, newsletter templates, and PocketBase backend for self-hosting or local development.
The site is deployed at organizedglitter.app. That hosted service is operated separately from this source tree.
- Tracks diamond art projects from wishlist through completed and archived states.
- Tracks coloring books, pages, mediums, publishers, illustrators, and progress notes.
- Stores progress notes with dates and photos.
- Organizes tags, companies, artists, and related metadata.
- Provides filtering, sorting, search, import/export, and a project randomizer.
- Keeps user data private by default through PocketBase collection rules.
- React 19, TypeScript, Vite, React Router
- PocketBase for auth, collections, file storage, and hook endpoints
- TanStack Query, React Hook Form, Zod
- Tailwind CSS 4 and local design-system components
- Vitest, Testing Library, and Playwright
See PRODUCT.md, DESIGN.md, and docs/README.md.
- Node.js 24.x
- pnpm 11.1.2 or newer
- PocketBase 0.40.5 for local database work
The repo includes an .nvmrc set to Node 24.
Install dependencies:
pnpm installBootstrap a local PocketBase instance with the committed schema and seed data:
pnpm pb:install:test -- --destination=local-pb-db/pocketbase
LOCAL_POCKETBASE_TEST_USER_EMAIL=local-user@example.test VITE_POCKETBASE_URL=http://localhost:8090 pnpm pb:bootstrap:local -- --seed --no-keepaliveStart PocketBase:
pnpm pb:localIn a second terminal, start the app against local PocketBase:
pnpm dev:localSeeded local login:
Email: local-user@example.test
Password: local-test-password-123Copy .env.example to .env when you need tooling credentials
or custom contact settings.
Full setup details: docs/pocketbase/local-development.md.
You need:
- A built static frontend (
pnpm buildwithVITE_POCKETBASE_URLandVITE_APP_URLset to your deployment origins) - A PocketBase instance with the committed hooks and migrations applied
- Optional mail configuration for feedback (
FEEDBACK_TO_EMAIL)
The included Node server in server/local-build-server.js can serve the built
app locally or behind your reverse proxy. See docs/README.md
for architecture and contracts.
Spacefast adapter code lives in spacefast/, as Organized Glitter is hosted on
Spacefast. The adapter is optional for self-hosting.
pnpm dev:local
pnpm typecheck
pnpm lint
pnpm test
pnpm build
pnpm pb:validate:schema
pnpm pb:validate:migrationssrc/ React web app
pb_hooks/ PocketBase hook endpoints
pb_migrations/ PocketBase migrations
server/ Static app server and route policy
docs/ Architecture, schema, and contributor docs
e2e/ Playwright specs
scripts/ Bootstrap, validation, and test helpers- Native iOS app (Apache-2.0): organized-glitter-app
See CONTRIBUTING.md.
Licensed under the GNU Affero General Public License v3.0 or later. See
LICENSE, NOTICE, and BRAND.md.
See the official deployment boundary and public configuration example. Ops builds a pinned public revision and supplies official services and credentials. The public source preserves the entire website. Optional integrations are disabled when configuration is absent.