chx2/budget.io

This package is abandoned and no longer maintained. No replacement package was suggested.

A budget application

v0.5-alpha 2021-04-16 15:37 UTC

Requires

• php: ^7.3|^8.0
• fideloper/proxy: ^4.2
• fruitcake/laravel-cors: ^2.0
• guzzlehttp/guzzle: ^7.0.1
• inertiajs/inertia-laravel: ^0.3.4
• laravel/framework: ^8.0
• laravel/tinker: ^2.0
• niklasravnsborg/laravel-pdf: ^4.0
• tightenco/ziggy: ^1.0

Requires (Dev)

• barryvdh/laravel-debugbar: ^3.5
• facade/ignition: ^2.3.6
• fzaninotto/faker: ^1.9.1
• mockery/mockery: ^1.3.1
• nunomaduro/collision: ^5.0
• phpunit/phpunit: ^9.3
• vimeo/psalm: ^4.6

MIT

• framework
• laravel

README

About Budget.io

Budget.io is a web-based budget application written in the Laravel framework, utilizing the Inertia.js driver to behave as a single-page application while using Laravel's built-in authentication and routing.

• Manage Your Budget - Create monthly budgets to track income, spending, and changes between your budget periods.

• Create Reports - Print off monthly reports, income, and expense statements separately.

• Gather Insights - Learn about trends over time when creating budgets. Learn through various charts about tips for improving areas of your budget and suggested improvements.

Installing Budget.io

1. Create the intial project by running the following command via Composer

composer create-project chx2/budget.io

1. Install dependencies via Composer & NPM:

composer install
npm install
npm run production

1. Replace the following values in the env.example file with your DB credentials:

DB_CONNECTION=
DB_HOST=
DB_PORT=
DB_DATABASE=
DB_USERNAME=
DB_PASSWORD=

1. Generate a .env file & run database migrations by running the following commands:

cp .env.example .env
php artisan key:generate
php artisan migrate

1. See deploying Laravel applications.

Developing Budget.io

This project is currently in alpha. Changes made to it currently may/may not cause unexpected changes to core application functionality. Contact me if you're interested into moving this application into a more stable version.

In order to set this up for testing, follow the installation steps above. It is recommended that you run the provided tests before committing:

php artisan test

Then run Psalm for code linting:

./vendor/bin/psalm --no-cache