Skip to content

TaslimOseni/naira-split-ai

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🇳🇬 Naira Split - The AI-Generated Bill Splitter

Naira Split is a minimalist Flutter application designed to help friends and groups split itemized bills easily, accurately, and down to the nearest Naira.

🤖 AI Experiment Notice: This entire project—from the initial scaffolding and architecture planning to the UI design, state management, and final README—was built entirely by an autonomous AI agent from start to finish with zero human intervention in the code.


🎤 Codable Conference Demo (March 14, 2026)

This project was built live, in under 10 minutes, as part of a demonstration for the Codable conference held on March 14, 2026. The goal of this demo was to explore the rapidly evolving landscape of AI in software development, specifically focusing on building the "software factory."

🚀 The Third Era of AI: Building the Factory

This project serves as a practical demonstration of what the Third Era of AI looks like in software development. According to the CEO of Cursor, the evolution of AI coding is defined by three distinct eras:

  1. The First Era (Autocomplete): Coding one keystroke at a time, assisted by AI tab-autocomplete.
  2. The Second Era (Chat & Prompting): Developers directing agents through synchronous prompt-and-response loops.
  3. The Third Era (Autonomous Agents): Agents tackling larger tasks independently, over longer timescales, with less human direction.

As the Cursor CEO explains:

"As a result, Cursor is no longer primarily about writing code. It is about helping developers build the factory that creates their software. This factory is made up of fleets of agents that they interact with as teammates: providing initial direction, equipping them with the tools to work independently, and reviewing their work. Many of us at Cursor are already working this way. More than one-third of the PRs we merge are now created by agents that run on their own computers in the cloud. A year from now, we think the vast majority of development work will be done by these kinds of agents."

Naira Split is a testament to this third era. The human provided the initial direction ("build a flutter app that allows users to split the bill amongst themselves to the nearest naira"), and the AI acted as an independent teammate to architect, code, debug, and deliver the final product.


📱 About the App

Naira Split takes the headache out of group dining. Instead of splitting the total evenly (which is unfair to the person who only had water!), Naira Split lets you assign specific items to specific people, calculating their exact share, including proportional tax and tip.

✨ Features

  • 👥 People Management: Quickly add the names of everyone at the table.
  • 🧾 Itemized Splitting: Add items from the receipt and assign them to one or multiple people. The cost is automatically divided among the assignees.
  • 💸 Proportional Tax & Tip: Enter your tax and tip as a flat Naira amount or a percentage. The app distributes these extra costs fairly based on what each person ordered.
  • 🎯 Nearest Naira Rounding: All final calculations are intelligently rounded to the nearest whole Naira for easy bank transfers.
  • 📤 Share Results: Automatically generate a clean text summary of who owes what, and share it directly to WhatsApp, iMessage, or any other app.
  • 🔒 Privacy First (Local Only): No accounts, no cloud sync, no data harvesting. Everything happens on your device and clears when you close the app.

🛠 Tech Stack

  • Framework: Flutter
  • Language: Dart
  • State Management: provider
  • Native Integration: share_plus (for the native sharing sheet)
  • Design System: Material 3 (Minimalist Theme)

💻 Getting Started

This project is a standard Flutter application.

Prerequisites

  • Flutter SDK (Version 3.0.0 or higher)
  • Android Studio / Xcode (for emulation)
  • A connected physical device or emulator

Installation

  1. Clone or download this repository.
  2. Navigate to the project directory:
    cd naira_split
  3. Install the dependencies:
    flutter pub get
  4. Run the app:
    flutter run

🤝 Contributing

As this is an AI-generated proof-of-concept, feel free to fork it, break it, and build upon it!

📝 License

This project is open-source and available under the MIT License.

About

An AI-generated Flutter app for splitting itemized bills to the nearest Naira. Built autonomously to demonstrate the Third Era of AI coding.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors