Welcome to the Zeepkist Community Hub, an open core ecosystem powering the Zeepkist community’s online tools and services.
The Zeepkist Community Hub consists of multiple interconnected projects working together to deliver a seamless competitive and social platform for Zeepkist players:
| Project | Role | Technologies | Link |
|---|---|---|---|
| Backend | Central backend service managing runs, ghosts, times, and leaderboards. Powers both the frontend website and the GTR mod. | Bun (TypeScript), PostgreSQL, Docker | Backend |
| PostGraphile GraphQL API | Public GraphQL API exposing flexible access to the backend data. | Node.js, PostGraphile, OpenTelemetry | PostGraphile GitHub |
| ZeepCentral | Community-facing website showcasing leaderboards, records, tournaments, and user data. | Nuxt 4, Vue 3 | ZeepCentral |
| GTR Mod | Game mod that supplies gameplay data to the backend and enhances in-game functionality. | C# (Unity mod) | GTR Mod on mod.io |
The Zeepkist Community Hub embraces an Open Core model that:
- Provides fully open source core backend services, APIs, and community tools to ensure transparency and foster community contributions.
- Encourages collaboration and extensibility across the community website (ZeepCentral), backend, and API projects.
- Keeps deployment orchestration—such as the Docker Compose setup—closed source, delivering a streamlined, official managed hosting solution.
- Balances openness and developer flexibility with efficient, reliable official deployment and maintenance.
The Backend is the heart of the Hub, providing:
- Secure REST APIs for mod and frontend communication.
- Persistent storage and fast retrieval of runs, ghosts, and records.
- Database migrations and schema management via Drizzle ORM.
- Scheduled jobs for leaderboards, history, and data upkeep.
- Integration with external services like Steam, Discord and Wasabi S3.
Requires Bun runtime and PostgreSQL.
- Exposes a powerful and customizable GraphQL endpoint backed by PostgreSQL.
- Supports complex queries and subscriptions with OpenTelemetry tracing.
Requires PostgreSQL.
- User-friendly website displaying world records, personal bests, tournament results and community data.
- Built with modern web technologies (Nuxt 4, Vue 3) for performance and scalability.
- Integrates seamlessly with the backend APIs.
Requires Bun runtime.
- Enhances the Zeepkist gameplay experience.
- Collects and submits gameplay data (times, ghosts) directly to the backend.
- Enables advanced in-game overlays and functionality tied to community data.
Requires .Net runtime.
Community contributions are warmly welcomed! Please see individual project repositories for contribution guidelines.
- Report bugs or request features via issues.
- Submit pull requests with improvements or fixes.
All open core projects are licensed under the MIT License.
