Objekt Tracker
A web explorer for Cosmo's Objekts, focused on the client-side experience. Cosmo is an app by Modhaus Inc. that decentralizes K-pop using blockchain technology; Objekts are its digital photocard NFTs.
Live at objekt.top.
Features
- Browse and filter every indexed Objekt collection
- Per-profile collections, pins, locks and ownership history
- Time travel: view any profile's collection as it was on a past date
- Trade lists (have/want) with matching between profiles
- Market listings and price tracking
- Live activity feed over WebSockets
Stack
| Layer | Technology |
|---|
| Runtime | Bun 1.4 |
| Frontend | TanStack React Start, Vite, React 19, Tailwind CSS 4 |
| API | ORPC (type-safe RPC) with Zod |
| Database | PostgreSQL 18, Drizzle ORM |
| Auth | Better Auth |
| Real-time | WebSockets, Valkey pub-sub |
| i18n | Inlang (Paraglide) |
| Indexer | Subsquid (EVM processor) |
| Lint/Format | oxlint, oxfmt |
Repository layout
| Path | Package | Purpose |
|---|
apps/web | web | Frontend, with an embedded WebSocket activity server |
apps/worker | worker | Background jobs (Croner) |
apps/indexer | indexer | On-chain NFT metadata indexer (Subsquid) |
packages/api | @repo/api | ORPC routers and services shared by the server |
packages/db | @repo/db | Drizzle schema and migrations for both databases |
packages/lib | @repo/lib | Shared utilities and types |
packages/cosmo | @repo/cosmo | Cosmo SDK |
packages/lint | @repo/lint | Shared oxlint config |
packages/tsconfig | @repo/tsconfig | Shared TypeScript configs |
Bun workspaces manage the packages, Turbo runs the tasks.
Getting started
Requirements: Bun 1.4+, PostgreSQL 18 and a Valkey/Redis instance. docker-compose.yml provides all of them if you'd rather not install them locally.
bun install
cp .env.example .env # then fill it in
All apps read the same root .env, so there is nothing to configure per package. The essential variables:
| Variable | Purpose |
|---|
DATABASE_URL | Main PostgreSQL connection |
INDEXER_DATABASE_URL | Indexer PostgreSQL connection |
REDIS_URL | Valkey (Redis-compatible) connection |
BETTER_AUTH_SECRET | Auth encryption key |
VITE_SITE_URL | Public site URL |
COSMO_KEY | Encrypted API key for the Cosmo SDK |
See .env.example for the full list, including S3 storage, SES mail, OAuth providers and indexer RPC settings.
Push the schema and start everything:
bun run --filter=@repo/db db:push
bun run dev
The web app is then served on http://localhost:3000.
Commands
Run from the repository root; --filter takes a package name.
bun run dev # start all dev servers
bun run dev --filter=web # start one app
bun run build # build everything
bun run lint # oxlint across the monorepo
bun run lint:fix # lint and auto-fix
bun run typecheck # type-check everything
bun run format # oxfmt across the monorepo
Database tasks live in @repo/db:
bun run --filter=@repo/db db:generate # generate a migration from the schema
bun run --filter=@repo/db db:migrate # apply migrations
bun run --filter=@repo/db db:studio # open Drizzle Studio
Docker
docker-compose.yml brings up the full stack: web, worker, indexer processor, both PostgreSQL instances with pgbouncer in front, and Valkey.
docker compose up -d
Contributing
Before opening a pull request, make sure bun run lint, bun run typecheck and bun run format are clean. CI runs the same checks and builds Docker images for any affected service.
Credit/Acknowledgment
- teamreflex/cosmo-web (Apollo) for Cosmo types, Cosmo utils and the Subsquid indexer. Some features are heavily inspired by Apollo.
License
MIT
Contact
