A web application for tracking and managing Tibia soulcore collections.
- Soul Core Tracking: Track which Soul Cores you've obtained and unlocked for your characters.
- Collaborative Lists: Create detailed lists of Soul Cores and invite friends to collaborate. Perfect for hunting teams or guilds.
- Group Chat: Each collaborative list includes a real-time chat for coordination, complete with unread message indicators.
- Character Verification: Securely verify your Tibia characters using a challenge-response verification system powered by the TibiaData API.
- Smart Suggestions: Receive contextual suggestions for which Soul Cores to hunt next based on your current progress.
# Clone the repository
git clone https://github.com/sergot/tibiacores.git
cd tibiacores
# Copy environment configuration
cp .env.example .env
# Start with Docker Compose
docker compose up -d
# Access at http://localhost:5173For detailed setup instructions, including OAuth configuration, email services, and manual setup without Docker, see docs/setup.md.
- Backend: Go 1.25+, Echo Framework, PostgreSQL 17
- Frontend: Vue 3, TypeScript, TailwindCSS, Pinia
- Database: PostgreSQL with sqlc for type-safe queries
- Authentication: JWT, OAuth2 (Discord, Google)
- External Services: Mailgun (EU), EmailOctopus, TibiaData API
- Setup Guide - Development environment setup
- Database Schema - Database structure and migrations
- Contributing - Contribution guidelines
This project is licensed under the terms of the license included in the LICENSE file.
Please see CONTRIBUTING.md for details on how to contribute to this project.