PokeShare

A French-language Pokémon TCG collection tracker and sharing app. Users search cards from the TCGdex catalog, track their personal collection with Cardmarket price valuations, and share collections with friends.

Stack

Astro (SSR, Node standalone adapter) — no UI framework
Tailwind CSS v4 + basecoat-css
PocketBase for database and authentication
TCGdex API (French locale) for card data, with an in-memory server-side cache (src/lib/tcgdex-cache.ts)

Commands

Command	Action
`bun install`	Install dependencies
`bun run dev`	Start dev server at `localhost:4321`
`bun run build`	Build the production site to `./dist/`
`bun run preview`	Preview the production build locally

Production runs as a standalone Node server (node dist/server/entry.mjs), Node >= 22.12.

Environment variables

Variable	Description	Default
`POCKETBASE_URL`	URL of the PocketBase backend (auth + data)	`https://pokeshare.namarusaja.me`

Read at runtime (process.env), so the same Docker image can be deployed against different PocketBase instances. For local dev, copy .env.example to .env. HOST and PORT are also honored by the standalone server.

Docker

docker build -t pokeshare .
docker run -p 4321:4321 -e POCKETBASE_URL=https://pb.example.com pokeshare

Structure

src/pages/ — routes (/, /search, /mycards, /card/[id], /series/[id], /sets/[id], /friends, /profile) and JSON API endpoints under src/pages/api/
src/middleware.ts — per-request PocketBase client + pb_auth cookie auth
src/lib/ — TCGdex cache, collection pricing helpers, type theming
src/layouts/, src/components/ — base layout and nav

2.2 KiB Raw Blame History