A comprehensive toolkit for Albion Online players featuring market analysis, build databases, PvP intelligence, and profit calculators.
- Market Flipper - Real-time arbitrage opportunities across all cities
- Gold Price Tracker - Monitor gold market trends and history
- Price Alerts - Get notified for profitable market opportunities
- Crafting Calculator - Calculate crafting profits with return rates
- Farming Profits - Crop and animal yield calculator
- Cooking Profits - Food crafting profitability
- Alchemy Profits - Potion brewing calculator
- Animal Breeding - Breeding profit calculator
- Enchanting Profits - Enchanting success rate calculator
- Labourer Profits - Labourer yield calculator
- Chopped Fish Profits - Fish processing calculator
- PvP Intel - Player statistics, killboards, and battle analysis
- Killboard - Real-time kill notifications
- ZvZ Tracker - Large-scale battle analytics and leaderboards
- Character Builds - Community-submitted builds for all game modes
- Build Sharing - Share and discover meta builds
- Equipment Planner - Plan your gear setups
- Multi-language Support - Available in 10+ languages
- PWA Support - Install as a progressive web app
- Dark/Light Theme - Customizable UI themes
- Node.js 20+ and npm
- Albion Online API access (via Albion Data Project)
-
Clone the repository
git clone https://github.com/yourusername/albionkit.git cd albionkit -
Install dependencies
npm install
-
Set up environment variables
cp .env.example .env.local
Edit
.env.localand fill in your API keys:- Firebase credentials (Optional)
-
Run the development server
npm run dev
-
Open the application
Navigate to http://localhost:3000
albionkit/
├── src/
│ ├── app/ # Next.js App Router pages
│ │ ├── tools/ # Market flipper, PvP intel, ZvZ tracker
│ │ ├── profits/ # Profit calculators
│ │ ├── builds/ # Build database
│ │ └── api/ # API routes
│ ├── components/ # React components
│ │ ├── ui/ # Reusable UI components
│ │ └── [feature]/ # Feature-specific components
│ ├── lib/ # Utility libraries and services
│ ├── hooks/ # Custom React hooks
│ ├── context/ # React Context providers
│ ├── i18n/ # Internationalization config
│ └── data/ # Static data files
├── messages/ # Translation files (10 languages)
├── public/ # Static assets
├── docs/ # Documentation
└── scripts/ # Utility scripts
- Framework: Next.js 16 (App Router)
- Language: TypeScript 5
- UI: React 19 with Tailwind CSS 4
- State: React Context + Custom Hooks
- Backend: Firebase (Auth + Firestore)
- i18n: next-intl
- Charts: Recharts
- Icons: Lucide React
- Deployment: Vercel
AlbionKit supports 10 languages:
- English (en)
- German (de)
- Spanish (es)
- French (fr)
- Korean (ko)
- Polish (pl)
- Portuguese (pt)
- Russian (ru)
- Turkish (tr)
- Chinese (zh)
See docs/TRANSLATION_GUIDE.md for contribution guidelines.
We welcome contributions! Please see our Contributing Guide for details.
- 🌍 Translations - Help translate the app to more languages
- 🐛 Bug Reports - Submit issues for bugs you find
- 💡 Feature Requests - Suggest new features
- 📝 Documentation - Improve docs and guides
- 💻 Code - Submit PRs for features or fixes
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
Please review our Security Policy for reporting vulnerabilities.
Important: Never commit .env.local or any file containing API keys to version control.
Support this project by becoming a sponsor!
Your support helps keep AlbionKit free and ad-free for everyone!
This project is licensed under the MIT License - see the LICENSE file for details.
- Albion Online by Sandbox Interactive
- Albion Data Project for API access
- All contributors and supporters
- Discord: (Coming soon!)
- Twitter: @Albion_Kit
- Email: support@albionkit.com
Built with ❤️ for Albion Online Community by Cosmic-fi (Albion Team)