nlevesque
1cfbf1db49
The Directus read permission intentionally allows friends' collections (used by /friends/[username]); the own-collection pages need an explicit user = current-user filter on top of it.
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
- Directus for database, authentication and permissions
(via
@directus/sdk) - 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 |
|---|---|---|
DIRECTUS_URL |
URL of the Directus backend (auth + data) | https://directus.namarusaja.me |
Read at runtime (process.env), so the same Docker image can be deployed
against different Directus instances. For local dev, copy .env.example to
.env. HOST and PORT are also honored by the standalone server.
Docker
Single container (external Directus):
docker build -t pokeshare .
docker run -p 4321:4321 -e DIRECTUS_URL=https://directus.example.com pokeshare
Or with the compose file:
DIRECTUS_URL=https://directus.example.com docker compose up --build
- The app listens on
4321; expose it on your domain (Coolify: expose theappservice, or use the plain Dockerfile build pack). - Collections, roles and permissions are managed from the Directus Data Studio; public registration is enabled with the "App User" role.
Structure
src/pages/— routes (/,/search,/mycards,/card/[id],/series/[id],/sets/[id],/friends,/profile,/login,/register) and JSON API endpoints undersrc/pages/api/src/middleware.ts— Directus session (directus_authcookie) with token refresh, exposeslocals.directusandlocals.usersrc/lib/— Directus client + types, TCGdex cache, collection pricing, auth helper, type themingsrc/layouts/,src/components/— base layout and nav