Skip to content
StandkreisPublic

Latest commit

 

History

219 Commits

Folders and files

Repository files navigation

🌿 standkreis-dex

A personal collection layer over open biodiversity data: see what could be living around you right now, learn about it before you meet it, and fill the silhouette when you do. Web first, phone later, free forever.

Explore the codebase: Inside the Atlas — interactive architecture guide · how to open and refresh it. Includes the system map, every database model, request walkthroughs, external dependencies and a searchable source snapshot.

🗺️ Roadmap 📄 Spec 📖 Glossary 💬 Records 🖼️ Reference screenshots
docs/ROADMAP.md docs/specs/0001 docs/GLOSSARY.md 0001 · 0002 docs/adr/0001-…/ with the UI findings

🏗️ Stack

Next.js App Router · TypeScript strict · Tailwind 4 · next-intl (de, en) · tRPC · Prisma · Postgres. PWA now, Capacitor wrap of the static export later.

Current setup, architecture and verification: docs/DEVELOPMENT.md. Use Node 24 (.nvmrc).

🚀 Run

cd app && npm install          # generates the Prisma client (postinstall)
npm run db:up                  # Postgres in Docker on :5433
# Existing dev DB: use its deployed schema. For a fresh disposable setup see docs/DEVELOPMENT.md.
npm run dev                    # http://localhost:3000 → /de or /en
Script Does
npm run check typecheck · lint · unit tests · static export · production server build (requires a seeded database)
npm run build:export Experimental static artifact in out/; API, cookie and dynamic-route hosting still need a deployment contract
node scripts/shot.mjs /de dark out.png 390 × 844 screenshot in a colour scheme, via headless Chrome

Production: push to main deploys to atlas.standkreis.de on Vercel with Neon and Blob, see docs/DEPLOY.md.

🗂️ Layout

app/
  prisma/            schema, migrations, seed (one dev identity)
  src/app/[locale]/  the four tabs; (root)/ picks the browser language once
  src/app/api/trpc/  the only API, cookie-bound anonymous identity
  src/components/    Shell (bottom bar), Marks (icons, badges), LogSheet
  src/i18n/          routing, de.json, en.json — keys not sentences, de is the source of truth
  src/styles/        tokens.css — 15 colours, light default, dark follows the system
  src/server/        Prisma client, tRPC context and routers
docs/                research, record, spec, handoffs, screenshots

Releases

Packages

Contributors

Languages