TrakrLog is a free, open-source event logging and analytics platform designed specifically for indie game and SaaS developers. Own your data, self-host your analytics, and gain deep insights into your applications without the complexity or cost of enterprise solutions.
Track everything from critical bugs to user behavior, performance metrics to custom events—all in real-time with an intuitive dashboard and powerful analytics tools.
- 🎮 Built for Indie Devs: First-class support for game engines (Unity, Godot) and web frameworks
- 💰 100% Free & Open Source: No hidden costs, no usage limits, no vendor lock-in
- 🔒 Privacy-First: Self-host and own your data completely
- ⚡ Real-Time Insights: Track events as they happen with lightweight SDKs
- 🎯 Simple Integration: Get started in minutes, not hours
- 📊 Powerful Analytics: Deep insights without the complexity
- Real-time Event Logging - Track gameplay events, performance metrics, and system data instantly
- Advanced Analytics - Powerful dashboards with detailed insights and visualizations
- Project & Channel Organization - Organize events by projects and channels for clarity
- Custom Event Tags - Attach custom metadata to events for flexible filtering
- User Insights - Understand how users experience your game or app
- Smart Notifications - Get real-time alerts for critical events
- Google OAuth Integration - Secure authentication out of the box
- Multi-Engine SDK Support - Native SDKs for Godot, Unity, React, Node.js, and more
- REST API - Simple HTTP endpoints for easy integration
- Self-Hosted - Full control with Docker deployment
- Lightweight - Performance-optimized for minimal overhead
- TypeScript Support - Fully typed for better DX
- Docker and Docker Compose
- (Optional) Google OAuth credentials for authentication
-
Clone the repository
git clone https://github.com/trakrlog-com/trakrlog.git cd trakrlog -
Configure environment (optional for OAuth)
# Edit .env.local if you want to test Google OAuth nano .env.local -
Start the application
make docker-run # Or manually: docker compose -f docker-compose.local.yml --env-file .env.local up --build -
Access the application
- Frontend: http://localhost:4000
- API Health: http://localhost:4000/api/health
- MongoDB: localhost:27017
-
Stop the application
make docker-down # Or manually: docker compose -f docker-compose.local.yml down
-
Install dependencies
# Backend go mod download # Frontend cd frontend npm install
-
Build the application
make build
-
Run with live reload
# Backend (installs air if needed) make watch # Frontend (in separate terminal) cd frontend npm run dev
- Go 1.25+ - High-performance API server
- Gin - Web framework with routing and middleware
- MongoDB - Flexible document database for events and analytics
- OAuth2 - Google authentication integration
- React 19 - Modern UI with hooks and context
- TypeScript - Type-safe development
- Vite - Lightning-fast build tool
- Tailwind CSS 4 - Utility-first styling
- Headless UI - Accessible component primitives
- Heroicons - Beautiful hand-crafted icons
- React Router - Client-side routing
- Luxon - DateTime handling
- Docker - Containerized deployment
- Caddy - Automatic HTTPS and reverse proxy
- Air - Live reload for Go development
- Testcontainers - Integration testing with containers
trakrlog/
├── cmd/api/ # Application entry point
├── internal/ # Private application code
│ ├── auth/ # Authentication logic (Google OAuth)
│ ├── database/ # Database connection and utilities
│ ├── handler/ # HTTP request handlers
│ ├── middleware/ # HTTP middleware (auth, CORS, etc.)
│ ├── model/ # Data models (Project, Channel, Event, User)
│ ├── repository/ # Database operations layer
│ ├── server/ # Server setup and routing
│ └── service/ # Business logic layer
├── frontend/ # React application
│ ├── src/
│ │ ├── components/ # React components
│ │ ├── pages/ # Page components
│ │ ├── context/ # React context providers
│ │ ├── hooks/ # Custom React hooks
│ │ └── types/ # TypeScript type definitions
│ └── public/ # Static assets
├── docs/ # Documentation
├── docker-compose.*.yml # Docker configurations
└── Makefile # Build and development commands
# Run all tests
make test
# Run integration tests (requires Docker)
make itest
# Frontend tests
cd frontend
npm run test- Local Testing Guide - Detailed guide for local development
- Deployment Guide - Production deployment instructions
- VPS Deployment - Deploy to a VPS
We welcome contributions from the community! Whether you're fixing bugs, adding features, or improving documentation, your help makes TrakrLog better for everyone.
- Fork the repository
- Create a feature branch
git checkout -b feature/amazing-feature
- Make your changes
- Follow existing code style and conventions
- Add tests for new features
- Update documentation as needed
- Commit your changes
git commit -m 'Add some amazing feature' - Push to your branch
git push origin feature/amazing-feature
- Open a Pull Request
- Code Style: Follow Go and TypeScript best practices
- Commits: Write clear, descriptive commit messages using conventional commits notation.
- Tests: Add tests for new functionality
- Documentation: Update README and docs for significant changes
- Issues: Check existing issues before creating new ones
- 🎮 SDK Development - Unity, Godot, Unreal Engine integrations
- 📊 Analytics Features - New visualization and insights tools
- 🐛 Bug Fixes - Check our issues
- 📝 Documentation - Improve guides and tutorials
- 🌐 Translations - Help us reach more developers worldwide
make all # Build frontend, backend, and run tests
make build # Build the entire application
make run # Run the application natively
make docker-run # Start local containerized environment
make docker-down # Stop local containers
make test # Run all tests
make itest # Run integration tests
make watch # Run with live reload (uses air)
make clean # Remove build artifactsThis project is open source and available under the GNU AFFERO GENERAL PUBLIC LICENSE.
If you find TrakrLog useful, please consider:
- ⭐ Starring the repository
- 🐛 Reporting bugs and requesting features
- 🤝 Contributing to the codebase
- 📢 Spreading the word to other indie developers
- GitHub: @trakrlog-com
- Website: trakrlog.com
- Issues: GitHub Issues
Made with ❤️ for indie developers by indie developers
Own your data. Own your analytics.