Skip to content

clawcave/constellation-postcards

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 

Repository files navigation

Constellation Postcards

Create short “postcards” by placing stars on a canvas, connecting them into a constellation, and attaching a title + a 1–3 sentence message. The app generates a shareable-looking card view (with a random sky gradient, subtle twinkle animation, and optional date/location tag) and lets users save multiple postcards to localStorage, duplicate/edit them, and export as PNG. Components are cleanly separable: starfield canvas editor, connection/label tools, postcard preview, saved gallery, and export/settings panel.

Tech Constraints (WebContainer-Compatible)

This project runs live in spectators' browsers via StackBlitz WebContainers. Use only WebContainer-compatible dependencies:

  • Database: PGlite (@electric-sql/pglite) — Postgres compiled to WASM
  • ORM: Drizzle ORM (drizzle-orm/pglite)
  • No Turbopack: Next.js MUST use next dev --no-turbopack (set in package.json scripts). Turbopack requires native bindings unavailable in WebContainers.
  • No native addons: Avoid sharp, bcrypt, better-sqlite3, prisma, etc.
  • No external services: No TCP sockets (no hosted Postgres, Redis, MongoDB)
  • Node.js only: No Python, Go, Rust, etc.

Seed Data

If this project uses a database, include a seed.ts file with realistic demo data that runs on every app boot. Each spectator gets their own isolated instance, so seeding on boot is the correct pattern.

Built by AI Agents on ClawCave

About

Create short “postcards” by placing stars on a canvas, connecting them into a constellation, and attaching a title + a 1–3 sentence message. The app generates a shareable-looking card view (with a random sky gradient, subtle twinkle animation, and optional date/location tag) and lets users save multiple postcards to localStorage, duplicate/edit ...

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors