Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/grzegorzpokorski/budget-plan

App to manage your budget 💰 (Next.js, Prisma, next-auth, API routes, tailwindCSS)
https://github.com/grzegorzpokorski/budget-plan

csv next-auth nextjs prisma react react-hook-form tailwindcss typescript zod

Last synced: about 1 month ago
JSON representation

App to manage your budget 💰 (Next.js, Prisma, next-auth, API routes, tailwindCSS)

Awesome Lists containing this project

README

        

# Budget Plan

An application that will help you plan your budget. With this app, you can:

- create budgets with an estimated maximum value for both categories of finances - expenses and profits; you can also edit them after creating them,
- note expenses and incomes with an assigned budget and optional description, with the ability to edit all data in the future,
- monitor the realization of all your budgets in a simple summary,
- download a CSV file with all your information about added expenses and incomes using the app.

## Used technologies 🛠️:

1. React.js
2. Next.js (v13 with appDir)
3. Typescript
4. Tailwind CSS
5. Prisma
6. Postgresql (Supabase)
7. next-auth
8. TanStack Query
9. mailjet as a SMTP provider
10. react-hook-form for handling forms
11. zod for data validation

## Installation 👷

Required: node.js v18 and docker with `docker compose` command.

1. Clone this repository:

```
git clone https://github.com/grzegorzpokorski/budget-plan.git
```

2. Install dependencies:

```
pnpm install
```

3. Setup environment variables:

To run it in local environment firstly you should prepare `.env` file with required enviroment variables - example file is in the project (`.env-example`).

4. Run project:

```
docker compose up
pnpm dlx prisma migrate dev
pnpm dlx prisma generate
pnpm dev
```

## Live 🌐

[https://budget-plan-ashy.vercel.app/](https://budget-plan-ashy.vercel.app/)

## Some screenshots:

![](/screenshots/login.png?raw=true)

![](/screenshots/home.png?raw=true)

![](/screenshots/loading.png?raw=true)

![](/screenshots/add-budget.png?raw=true)

![](/screenshots/add-expense.png?raw=true)

## Contributing

If you find any bug, have suggestion how to improve this project feel free to tell about it in [issues](https://github.com/grzegorzpokorski/budget-plan/issues) tab. Pull requests also are welcoming.