A modern expense splitting app that takes the hassle out of shared finances. Billicious helps groups track, split, and settle expenses in real-time with minimal friction.
- Eliminate Payment Confusion: Smart algorithms automatically calculate the optimal way to settle group debts
- Real-Time Peace of Mind: Instant updates keep everyone on the same page about shared expenses
- Simplified Group Finance: Handle multiple groups, categories, and complex splitting scenarios with ease
- Smart Bill Splitting: Automatically calculate and divide expenses among group members with customizable splitting options
- Real-time Collaboration: Instant updates when group members add expenses or settle debts using Supabase Realtime
- Expense Categories: Organize expenses with customizable categories for better tracking along with detailed transaction history with filtering and search capabilities
- Settlement Tracking: Clear visualization of who owes whom and simplified debt settlement process
- Group Management: Create and manage multiple groups for different occasions (roommates, trips, events)
- Dark/Light Mode: User-friendly interface with theme support
- Responsive Design: Works seamlessly across desktop and mobile devices
- Reduces time spent on expense calculations by 90%
- Prevents common splitting mistakes and disputes
- Supports multiple currency conversions and split types
- Privacy-focused with modern passkey authentication
- Frontend: Next.js 14
- Backend: Supabase
- State Management: Zustand
- Data Fetching and Mutations: Tanstack Query
- UI Components: Shadcn UI
- Real-time Updates: Supabase Realtime
- Passkeys Authenication: Hanko
- Node.js
- npm or yarn
- Supabase account
- Hanko account
-
Clone the repository:
git clone https://github.com/BioHazard786/billicious.git cd billicious -
Install dependencies:
npm install # or yarn install -
Set up environment variables: Create a
.envfile in the root directory and vars given inexample.envand types inenv.d.ts.
-
Start the development server:
npm run dev # or yarn dev -
Open your browser and navigate to
http://localhost:3000.
The project directory structure is as follows:
billicious/
├── app/ # Next.js app directory
├── auth-utils/ # Utility functions for supabase
├── components/ # Reusable UI components
├── constants/ # constants
├── providers/ # state management and query providers
├── lib/ # Utility functions and types
├── store/ # Zustand store configurations
├── server/ # Server-side actions and API
└── database/ # Database configurations
Contributions are welcome! Please fork the repository and create a pull request with your changes.
This project is licensed under the MIT License. See the LICENSE file for details.