Skip to content
/ Spense Public

Simple expense sharing app to split bills and track who owes what — perfect for friends, roommates, and group trips.

License

Notifications You must be signed in to change notification settings

xRomory/Spense

Repository files navigation

Spense

Spense is a lightweight expense-sharing web application designed to help people split bills and keep track of who owes what — without the friction of sign-ups or complicated setup.

Perfect for roommates, friends, and group trips, Spense makes shared expenses simple, transparent, and stress-free.

_ Spense is built with simplicity in mind — focusing on clarity, fairness, and ease of use when sharing expenses.


Purpose

Managing shared expenses often leads to confusion, forgotten payments, or awkward conversations.
Spense solves this by providing a clear, visual, and automatic way to track group expenses and balances — so everyone knows exactly where they stand.

No accounts. No hassle. Just fair splitting.


Key Features

  • Auto-generated Join Code / Invite Link
    Create a group instantly and invite others using a shareable code or link.

  • No Sign-Up Required
    Start tracking expenses right away — no accounts, passwords, or emails needed.

  • Smart Expense Splitting
    Automatically calculates who owes what with:

    • Equal splits
    • Custom splits (different amounts per person)
  • Clear Balance Overview
    Easily see:

    • Who owes money
    • Who is owed money
    • Net balances with visual indicators
  • Group-Based Expense Tracking
    Add friends or roommates and track shared expenses together in one place.


How It Works

  1. Create a Group
    Generate a join code or invite link.

  2. Invite Members
    Share the code/link with friends or roommates.

  3. Add Expenses
    Log expenses and choose how they should be split.

  4. Track Balances
    Instantly see debts and credits update in real time.


Tech Stack

Frontend

  • Next.js 16
  • React 19
  • TypeScript
  • Tailwind CSS
  • Radix UI (Dialog, Tabs, Labels)
  • Lucide Icons

State & Data Management

  • Zustand – lightweight global state
  • @tanstack/react-query – async data handling
  • React Hook Form – form management
  • Zod – schema validation

UI & UX Enhancements

  • next-themes – theme handling
  • sonner – toast notifications
  • clsx / tailwind-merge – conditional styling
  • react-error-boundary – error handling

Project Scripts

# Run development server
npm run dev

# Build for production
npm run build

# Start production server
npm run start

# Run linting
npm run lint

Project Status

Spense is currently in active development.


License

This project is licensed under the MIT License.

You are free to use, modify, and distribute this software for personal or commercial purposes, as long as proper credit is given.

Spense was built as a personal utility project to simplify shared expense tracking with friends and roommates. Contributions and improvements are welcome.


About

Simple expense sharing app to split bills and track who owes what — perfect for friends, roommates, and group trips.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published