<p align="center"> <img src="https://raw.githubusercontent.com/RzlAm/incomex/refs/heads/main/public/web-app-manifest-512x512.png" alt="Incomex Logo" width="100" height="100" /> </p> <h1 align="center">Incomex</h1> <p align="center"><i>Personal daily income and expense tracker</i></p> <p align="center"> <a href="https://github.com/RzlAm/incomex/stargazers"><img src="https://img.shields.io/github/stars/RzlAm/incomex?style=social" alt="Stars"></a> <a href="https://github.com/RzlAm/incomex/network/members"><img src="https://img.shields.io/github/forks/RzlAm/incomex?style=social" alt="Forks"></a> <a href="https://github.com/RzlAm/incomex/graphs/contributors"><img src="https://img.shields.io/github/contributors/RzlAm/incomex" alt="Contributors"></a> <br> <a href="https://github.com/RzlAm/incomex/issues"><img src="https://img.shields.io/github/issues/RzlAm/incomex" alt="Issues"></a> <a href="https://github.com/RzlAm/incomex/blob/main/LICENSE"><img src="https://img.shields.io/github/license/RzlAm/incomex" alt="License"></a> <a href="https://trakteer.id/rzlam/tip"><img src="https://img.shields.io/badge/Donate-Trakteer-orange" alt="Donate"></a> </p> <img src="https://raw.githubusercontent.com/RzlAm/incomex/refs/heads/main/public/Screenshot.png" alt="Screenshot" />

🧾 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

Clone the repository

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

Copy the .env file

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

Generate the app key
```
php artisan key:generate
```

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=

Install dependencies

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

Optimize Filament
```
php artisan filament:optimize
```
Run database migration and seed
```
php artisan migrate:fresh --seed
```
(Optional) Run this command to seed example transactions
```
php artisan db:seed --class=TransactionSeeder
```
Start the application
```
php artisan serve
```
Open http://localhost:8000 in your browser.

🤝 Contributing

Fork this repository
Clone your fork locally
Create a new branch for your feature/fix
Make your changes and commit them
Push your branch to your fork
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 😄

Incomex

Install / Use

README