https://github.com/lalitdotdev/ynab
Ynab —— You Need A Budget ! is a personal finance app that helps you manage your money better. Budgeting Upwards & Disciplined!
https://github.com/lalitdotdev/ynab
budget-tracker clerkauth finance-management nextjs postgres prisma-orm typescript
Last synced: 7 months ago
JSON representation
Ynab —— You Need A Budget ! is a personal finance app that helps you manage your money better. Budgeting Upwards & Disciplined!
- Host: GitHub
- URL: https://github.com/lalitdotdev/ynab
- Owner: lalitdotdev
- License: mit
- Created: 2024-04-28T08:26:02.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-05-31T08:30:43.000Z (over 1 year ago)
- Last Synced: 2025-01-17T03:39:06.874Z (9 months ago)
- Topics: budget-tracker, clerkauth, finance-management, nextjs, postgres, prisma-orm, typescript
- Language: TypeScript
- Homepage: https://youneedabudget.vercel.app
- Size: 1.53 MB
- Stars: 1
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Ynab —— You Need A Budget!!
Ynab is a personal finance app designed to help you manage your money better by budgeting upwards and maintaining financial discipline. This application allows you to track your income and expenses, set a default currency for transactions, create and manage categories, and view transaction history within a specified date range.
## Features
- **Transaction Management**: Add, edit, and delete transactions with ease. View your transaction history filtered by date range.
- **Budgeting**: Categorize your income and expenses to maintain a disciplined budget. Create custom categories for better organization.
- **Currency Settings**: Set and manage your default currency for all transactions.
- **Date Range Picker**: Easily select and view transactions within a specific date range.
- **Data Export**: Export your transaction history to CSV format for offline access and analysis.
## Getting Started
### Prerequisites
- Node.js (v14 or higher)
- pnpm(v8 or higher) or npm (v6 or higher) or Yarn (v1.22 or higher)
- PostgreSQL (or any other SQL database)
### Installation
1. Clone the repository:
```bash
git clone https://github.com/yourusername/ynab.git
cd ynab
```
2. Install dependencies:
```bash
pnpm install
# or
npm install
# or
yarn install
```
3. Set up the environment variables. Create a `.env` file in the root directory and add the following:
```env
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=
CLERK_SECRET_KEY=
NEXT_PUBLIC_CLERK_SIGN_IN_URL=/sign-in
NEXT_PUBLIC_CLERK_SIGN_UP_URL=/sign-up
NEXT_PUBLIC_CLERK_AFTER_SIGN_IN_URL=/
NEXT_PUBLIC_CLERK_AFTER_SIGN_UP_URL=/onboarding
```
4. SQlite prisma settings
```bash
provider = "sqlite"
DATABASE_URL="file:./dev.db"
```
5. Run the database migrations:
```bash
npx prisma migrate dev
```
6. Start the development server:
```bash
pnpm dev
# or
npm run dev
# or
yarn dev
```
7. Open your browser and navigate to `http://localhost:3000`.
### Deployment
For deploying the app to production, follow the documentation of your preferred hosting service (Vercel, Netlify, Heroku, etc.). Make sure to set the necessary environment variables in your hosting service's dashboard.
## Contributing
Contributions are welcome! If you'd like to contribute, please fork the repository and use a feature branch. Pull requests are warmly welcome.
1. Fork the repository.
2. Create your feature branch (`git checkout -b feature/new-feature`).
3. Commit your changes (`git commit -m 'Add some feature'`).
4. Push to the branch (`git push origin feature/new-feature`).
5. Create a new Pull Request.
## License
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
## Acknowledgements
- [React](https://reactjs.org/)
- [Next.js](https://nextjs.org/)
- [Prisma](https://www.prisma.io/)
- [date-fns](https://date-fns.org/)
- [Clerk](https://clerk.dev/)
- [Shadcn](https://shadcn.com/)
## Contact
For any inquiries or feedback, please contact us at mailfor.lalitsharma@gmail.com.
---
Happy Budgeting! 🚀