Documentation

Welcome to the helldivers.bot documentation. This site caches the official Helldivers 1 API, stores historic game data, and provides API access along with frontend visualizations.

Getting Started

• About — learn about the project and its creator
• FAQ — frequently asked questions about the war and how progress is tracked

Architecture

• Data Pipeline — interactive data flow diagram and key technical concepts
• Update Flow — worker pipeline, two-table strategy, and snapshot throttling
• Database Schema — Prisma 7 models, relationships, indexes, and ERD
• Notifications — live polling, toasts, Web Notifications, and push
• Authentication — BetterAuth OAuth, sessions, roles, and API keys

Reference

• Rebroadcast — interactive OpenAPI documentation for the Helldivers Bot API
• Utilities — shared helpers, Zod validators, formatting, and analytics
• Official — unofficial documentation of the official Helldivers 1 API
• Brand Kit — design tokens, colors, typography, and component reference

Development

• Infrastructure — Docker, CI/CD, initialization flow, and environment variables
• Testing — Vitest unit tests, smoke tests, and testing conventions