Incomex

Personal daily income and expense tracker

---

🧾 About Incomex

Incomex is a web app for tracking your daily income and expenses with ease. It supports multiple wallets and provides basic statistics to help you manage your finances.

---

✨ Features

• 🔐 Single-user support
• 👛 Custom wallets
• 📊 Basic financial statistics
• 🌍 Timezone and currency configuration
• 🏷️ Custom categories
• 🧾 Export CSV
• 💾 Manual DB backup
• 💯 100% open source

---

🚀 Installation

Incomex is self-hosted only. You can run it locally or on your preferred hosting service.

📥 Installation Steps

1. Clone the repository

   git clone https://github.com/RzlAm/incomex
   cd incomex

2. Copy the .env file

   php -r "file_exists('.env') || copy('.env.example', '.env');"

3. Generate the app key

   php artisan key:generate

4. Configure .env Example setup:

   APP_ENV=production
   APP_DEBUG=false
   APP_URL=http://localhost:8000
   
   DB_CONNECTION=mysql
   DB_HOST=127.0.0.1
   DB_PORT=3306
   DB_DATABASE=incomex
   DB_USERNAME=root
   DB_PASSWORD=

5. Install dependencies

   composer install --no-dev --no-interaction --prefer-dist --optimize-autoloader

6. Optimize Filament

   php artisan filament:optimize

7. Run database migration and seed

   php artisan migrate:fresh --seed

   (Optional) Run this command to seed example transactions

   php artisan db:seed --class=TransactionSeeder

8. Start the application

   php artisan serve

9. Open http://localhost:8000 in your browser.

---

🤝 Contributing

1. Fork this repository
2. Clone your fork locally
3. Create a new branch for your feature/fix
4. Make your changes and commit them
5. Push your branch to your fork
6. Create a Pull Request to the main repo

📝 Feel free to open Issues for feature requests, questions, or discussions.

---

📄 License

This project is licensed under the MIT License

---

☕ Support Us

Like this project? Consider supporting us on Trakteer 😄