Wiwit - A Finance Tracker App

Try it live at https://demo-wiwit.iqfareez.com.

Email: demo-user@example.com
Password: 12345678

Getting Started

Get your machine ready for Laravel development. You can install Herd and setup Laravel.

Clone repository, then run the following command to install dependencies and setup other stuff:

composer setup

Run the database migrations. By default, the database is mysql. You can change that in the .env file. If you don't have yet mysql setup, you can follow this tutorial to setup one.

php artisan migrate

Run the development server:

php artisan dev

Create Filament admin user:

php artisan make:filament-user

Then, navigate to http://127.0.0.1:8000/dashboard/ in your browser to see the app running.

Generate OpenAPI Docs

Swagger docs is generated using Scribe package. Update the APP_URL in the environment, this will be used to populate the server URL in the swagger doc and do response calls.

To generate docs, run:

php artisan scribe:generate

See also Scribe::beforeResponseCall hook in AppServiceProvider.php.

Scribe will use scribe.sqlite to store temporary data when generating docs. This sqlite only contains database schema (no data). To regenerate this file, delete the existing scribe.sqlite and run:

DB_CONNECTION=sqlite DB_DATABASE=database/scribe.sqlite php artisan migrate

Running Tests

Run the full test suite with:

composer test

Agentic Development

Laravel's predictable structure and conventions make it ideal for AI coding agents like Claude Code, Cursor, and GitHub Copilot. Install Laravel Boost to supercharge your AI workflow:

php artisan boost:install

Boost provides your agent 15+ tools and skills that help agents build Laravel applications while following best practices.

Attributions

• App logo/favicons from https://solar-icons.vercel.app/icons?search=wallet&icon=wallet

License

Copyright (C) 2026 Muhammad Fareez

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as published
by the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License
along with this program. If not, see <https://www.gnu.org/licenses/>.