Skip to content

About

Public web app and PocketBase backend for Organized Glitter

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

779 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Organized Glitter Web

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.

What it does

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

Tech stack

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

Prerequisites

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

Quick start

Install dependencies:

pnpm install

Bootstrap 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-keepalive

Start PocketBase:

pnpm pb:local

In a second terminal, start the app against local PocketBase:

pnpm dev:local

Seeded local login:

Email: local-user@example.test
Password: local-test-password-123

Copy .env.example to .env when you need tooling credentials or custom contact settings.

Full setup details: docs/pocketbase/local-development.md.

Self-hosting

You need:

  1. A built static frontend (pnpm build with VITE_POCKETBASE_URL and VITE_APP_URL set to your deployment origins)
  2. A PocketBase instance with the committed hooks and migrations applied
  3. 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.

Common commands

pnpm dev:local
pnpm typecheck
pnpm lint
pnpm test
pnpm build
pnpm pb:validate:schema
pnpm pb:validate:migrations

Repository layout

src/              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

Related projects

Contributing

See CONTRIBUTING.md.

License

Licensed under the GNU Affero General Public License v3.0 or later. See LICENSE, NOTICE, and BRAND.md.

Complete website and official services

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.

About

Public web app and PocketBase backend for Organized Glitter

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages