Overview
d-sports-api (package name:d-sports-pwa) is the main application: a Progressive Web App that provides the full fan engagement experience. It is both the backend and the web client.
- Default port: 3004
- Run:
bun dev
Tech stack
| Category | Technology |
|---|---|
| Framework | Next.js 16, React 19 |
| Database | PostgreSQL, Prisma 6.8 |
| Auth | Clerk 6.x |
| Styling | Tailwind CSS 4, Radix UI, shadcn/ui |
| Web3 | Thirdweb, Viem, Wagmi |
| Payments | RevenueCat (purchases-js) |
| State | TanStack Query, TanStack Store |
| Secrets | HashiCorp Vault (optional) |
| Package | Bun |
Features
- Locker room — Social feed, posts, comments, likes, following
- Gamification — Quests, points, achievements, leaderboards, Frontline Pass
- Digital collectibles — NFT-style collectibles, rarity tiers, pack opening, inventory
- Shop — Product catalog, cart, RevenueCat purchases
- Wallet — Web3 wallet, token balances, Thirdweb integration
- Interactive games — Trivia, wheel spin
- Team manager dashboard — Collectible creation, bulk upload, packs, analytics, revenue
- Admin — Impersonation, roles (SuperAdmin, Admin, TeamManager), user management
Getting started
- Clone the repository and install dependencies (
bun install). - Set up environment variables (see repo
.env.exampleor Vault setup in README). - Configure PostgreSQL and run
bun prisma db pullthenbun prisma generate. - Run
bun dev— app is at http://localhost:3004.
API
This app is the primary API surface for the D-Sports platform. The API reference in these docs covers endpoints and usage; detailed OpenAPI or API specs live in the repo.Ecosystem overview
See how d-sports-api fits with the site, native app, and Mic’d Up.