Trendshift - Ask AI

base on Badget aims to simplify financial management with a user-friendly interface and robust backend <a href="https://badget-eight-gilt.vercel.app/"> <h1 align="center">Badget: AI-Powered Financial Management Platform</h1> </a> <img width="1440" alt="dashboard_mockup" src="https://github.com/projectx-codehagen/Badget/assets/24507211/2c2b8e43-3d18-4b28-b8d0-5dc0cbdb530f"> Ushering in a new era of financial management with cutting-edge AI. Badget redefines how you track, analyze, and optimize your finances, ensuring smarter, more secure financial decisions.  <a href="https://github.com/projectx-codehagen/Badget/blob/main/LICENSE.md"> <img src="https://img.shields.io/github/license/projectx-codehagen/Badget?label=license&logo=github&color=f80&logoColor=fff" alt="License" /> </a> <a href="#introduction">Introduction</a> · <a href="#installation">Installation</a> · <a href="#tech-stack--features">Tech Stack + Features</a> · <a href="#architecture">Architecture</a> · <a href="#contributing">Contributing</a> ## Introduction Welcome to Badget, the "Copilot for Money" - an AI-powered financial management platform that provides unparalleled insights into your spending habits and financial patterns. Built with a family-first design, Badget empowers households to budget better, track expenses effortlessly, and achieve their financial goals through intelligent automation and real-time insights. **Key Features:** - **Unified Financial Dashboard** - All accounts in one place with smart categorization - **AI-Driven Insights** - Intelligent spending analysis and personalized recommendations - **Family-First Design** - Multi-user households with role-based permissions - **Real-time Financial Health** - Instant alerts, goal tracking, and financial scoring - **Automated Budgeting** - Dynamic budget creation based on spending patterns - *See [AI Budgeting Guide](docs/ai-budgeting-guide.md) (including [Using Vercel AI](docs/ai-budgeting-guide.md#using-vercel-ai)) for how to leverage these features* - **Advanced AI Tools** - Anomaly detection, spending forecasts and natural-language insights ## Architecture Badget implements a **dual-layer architecture** with clean separation between authentication and business logic: ### Authentication Layer - User identity and session management via **Better-auth** - OAuth provider integration (Google, GitHub, etc.) - Independent of business domain ### Application Layer - Financial domain models (accounts, transactions, budgets) - Family/household organization with role-based access - AI insights and recommendations engine - Core application business logic ## What we are using Next.js 15, Better-auth, Prisma, PostgreSQL, Shadcn/ui, Tailwind CSS, Framer Motion, and TypeScript. All seamlessly integrated to accelerate financial management innovation. ## Directory Structure Badget follows a clean, scalable architecture: . ├── src # Main project lives here │ ├── actions # Server actions for auth and business logic │ ├── app # Next.js App Router structure │ │ ├── (marketing) # Public marketing pages │ │ ├── api # API routes │ │ └── dashboard # Protected dashboard area │ ├── components # Reusable UI components │ │ ├── auth # Authentication components │ │ ├── sections # Landing page sections │ │ └── ui # Shadcn/ui components │ ├── lib # Utilities and configurations │ └── generated # Generated Prisma client ├── prisma # Database schema and migrations └── README.md ## Installation Clone & create this repo locally with the following command: ```bash git clone https://github.com/codehagen/Badget ``` 1. Install dependencies using pnpm: ```bash pnpm install ``` 2. Initialize Prisma with custom output directory: ```bash npx prisma init --db --output ../src/generated/prisma ``` 3. Copy `.env.example` to `.env.local` and update the variables: ```bash cp .env.example .env.local ``` 4. Set up your environment variables: The `.env.example` file contains detailed explanations for each variable. Key requirements: 1. **Database**: We are using [Prisma Database](http://prisma.io/) (This is created over) 2. **Authentication**: Configure Better-auth OAuth providers **For Google Auth Setup:** To use Google as a social provider, create a new project in the [Google Cloud Console](https://console.cloud.google.com/). In **Google Cloud Console > Credentials > Authorized redirect URIs**, set: - **Local development**: `http://localhost:3000/api/auth/callback/google` - **Production**: `https://yourdomain.com/api/auth/callback/google` 5. Push the database schema: ```bash # Generate Prisma client and push schema pnpm db:generate pnpm db:push ``` 1. Start the development server: ```bash # Start the development server with Turbopack pnpm dev ``` ## Tech Stack + Features ### Frameworks - [Next.js 15](https://nextjs.org/) – React framework with App Router for optimal performance - [Better-auth](https://better-auth.com/) – Modern authentication with OAuth providers (Google, GitHub) - [Prisma](https://www.prisma.io/) – Type-safe ORM with PostgreSQL - [React Email](https://react.email/) – Powerful email framework for notifications ### Platforms - [Vercel](https://vercel.com/) – Seamless deployment and preview environments - [Neon](https://neon.tech/) – Serverless PostgreSQL for scalable data management - [Resend](https://resend.com/) – Reliable email delivery infrastructure ### UI & Design - [Shadcn/ui](https://ui.shadcn.com/) – Beautiful components built on Radix UI and Tailwind CSS - [Magic UI](https://magicui.design/) – 150+ free animated components and effects for modern landing pages - [Tailark](https://tailark.com/) – Modern, responsive pre-built UI blocks for marketing websites - [Tailwind CSS](https://tailwindcss.com/) – Utility-first CSS for rapid development - [Framer Motion](https://framer.com/motion) – Smooth animations and micro-interactions - [Lucide](https://lucide.dev/) – Consistent, beautiful icons - [Recharts](https://recharts.org/) – Financial data visualization ### Core Features - **Multi-tenant Family System** - Role-based access control (Owner, Admin, Member, Viewer) - **Dual-layer Architecture** - Clean separation of auth and business logic - **Real-time Dashboard** - Live financial insights and account overview - **Responsive Design** - Mobile-first approach with beautiful UI/UX - **Type Safety** - End-to-end TypeScript for reliability ## Contributing We love our contributors! Here's how you can contribute: - [Open an issue](https://github.com/codehagen/badget/issues) if you believe you've encountered a bug. - Make a [pull request](https://github.com/codehagen/badget/pull) to add new features/make quality-of-life improvements/fix bugs. <a href="https://github.com/codehagen/badget/graphs/contributors"> <img src="https://contrib.rocks/image?repo=codehagen/badget" /> </a> ## Repo Activity ![Nextify repo activity – generated by Axiom](https://repobeats.axiom.co/api/embed/c03baff974deeb73d0da7788b8455d04f8e17fc8.svg "Repobeats analytics image")", Assign "at most 3 tags" to the expected json: {"id":"7714","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"

AI prompts