PHPackages                             iamrohitpal/roomie - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Framework](/categories/framework)
4. /
5. iamrohitpal/roomie

ActiveProject[Framework](/categories/framework)

iamrohitpal/roomie
==================

Group-based expense splitter with NativePHP and FCM V1 notifications.

1.0.0(1mo ago)00MITBladePHP ^8.2

Since Mar 28Pushed 1mo agoCompare

[ Source](https://github.com/iamrohitpal/roomie)[ Packagist](https://packagist.org/packages/iamrohitpal/roomie)[ RSS](/packages/iamrohitpal-roomie/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (11)Versions (2)Used By (0)

Roomie - Split Expenses, Not Friendships 🏠💸
===========================================

[](#roomie---split-expenses-not-friendships-)

 [![Roomie App Mockup](public/images/mockup.png)](public/images/mockup.png)

**Roomie** is a modern, group-centric expense tracking and splitting application built with **Laravel 12** and **NativePHP**. Designed for roommates who want a stress-free way to manage shared costs, Roomie simplifies everything from daily groceries to monthly utility bills with real-time notifications and offline support.

---

🌟 Key Features
--------------

[](#-key-features)

- **👥 Group Collaboration**: Scope expenses, roommates, and settlements to specific groups for better organization.
- **🔔 Real-Time Notifications**: Integrated with **Firebase Cloud Messaging (FCM) V1** for instant alerts on new expenses.
- **📱 Native Mobile Experience**: Leverages NativePHP for a smooth, app-like feel on Android devices.
- **📶 PWA &amp; Offline Support**: Service worker integration for reliable performance even without a connection.
- **💸 Smart Expense Splitting**: Split costs equally or by custom amounts with just a few taps.
- **⏳ Settlement Tracking**: Keep track of who owes what and mark debts as settled instantly.
- **👤 Profile &amp; Settings**: Personalize your profile and manage notification permissions.
- **🧹 Group Maintenance**: Securely clear group data or export financial reports to CSV.

---

🛠️ Tech Stack
-------------

[](#️-tech-stack)

- **Framework**: [Laravel 12.x](https://laravel.com)
- **Runtime**: [NativePHP](https://nativephp.com)
- **Notifications**: [Firebase Cloud Messaging (V1)](https://firebase.google.com/docs/cloud-messaging)
- **Frontend**: [Vite](https://vitejs.dev), [Vanilla CSS](https://developer.mozilla.org/en-US/docs/Web/CSS), [Blade](https://laravel.com/docs/blade)
- **Database**: SQLite (default for NativePHP)

---

🚀 Quick Start
-------------

[](#-quick-start)

### Prerequisites

[](#prerequisites)

- PHP 8.2+
- Composer
- Node.js &amp; NPM

### Installation

[](#installation)

1. **Clone the repository**:

    ```
    git clone https://github.com/iamrohitpal/roomie.git
    cd roomie
    ```
2. **Install dependencies**:

    ```
    composer install
    npm install
    ```
3. **Configure Environment**: Copy `.env.example` to `.env` and configure your Firebase credentials:

    ```
    FIREBASE_API_KEY=your_key
    FIREBASE_PROJECT_ID=your_id
    FIREBASE_MESSAGING_SENDER_ID=your_sender_id
    FIREBASE_APP_ID=your_app_id
    FIREBASE_VAPID_KEY=your_vapid_key
    ```
4. **Firebase Service Account**: Download your service account JSON from Firebase Console and save it as: `storage/app/firebase-auth.json`
5. **Run the setup**:

    ```
    php artisan key:generate
    php artisan migrate
    npm run build
    ```
6. **Start the development server**:

    ```
    composer run dev
    ```

---

📦 Building for Android
----------------------

[](#-building-for-android)

To generate a release build for Android:

```
php artisan native:run android --build=release
```

---

📜 License
---------

[](#-license)

Distributed under the MIT License. See `LICENSE` for more information.

---

**Built with ❤️ for roommates everywhere.**

###  Health Score

37

—

LowBetter than 83% of packages

Maintenance91

Actively maintained with recent releases

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity46

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

46d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/b829c0a19396f0a1d9f39638d03e1dc5aad4d3a3bf5c04e2cb478095492dd60e?d=identicon)[iamrohitpal](/maintainers/iamrohitpal)

---

Top Contributors

[![iamrohitpal](https://avatars.githubusercontent.com/u/77782416?v=4)](https://github.com/iamrohitpal "iamrohitpal (7 commits)")

---

Tags

frameworklaravel

###  Code Quality

TestsPHPUnit

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/iamrohitpal-roomie/health.svg)

```
[![Health](https://phpackages.com/badges/iamrohitpal-roomie/health.svg)](https://phpackages.com/packages/iamrohitpal-roomie)
```

###  Alternatives

[codewithdennis/larament

Larament is a time-saving starter kit to quickly launch Laravel 13.x projects. It includes FilamentPHP 5.x pre-installed and configured, along with additional tools and features to streamline your development workflow.

3691.5k](/packages/codewithdennis-larament)[ercogx/laravel-filament-starter-kit

This is a Filament v3 Starter Kit for Laravel 12, designed to accelerate the development of Filament-powered applications.

401.5k](/packages/ercogx-laravel-filament-starter-kit)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
