GitHub - LovelySharma-dev/Ledgerly-AI: AI-powered invoice management platform built with MERN, Clerk Authentication, and Google Gemini AI for smart invoice generation.

Modern AI-powered invoice management platform.

⚡ What it does

Ledgerly AI is a modern invoice management platform that helps freelancers, small businesses, and agencies create professional invoices in minutes.

Users can:

Create invoices manually using an intuitive invoice builder.
Describe an invoice in plain English and let Gemini AI generate the complete invoice automatically.
Review and edit any AI-generated details before saving.
Add company branding including logo, signature, and stamp.
Preview invoices in real time and export them as professional PDFs.
Organize invoices with search, filters, and status tracking.

Describe your invoice in natural language and AI generates a structured invoice that you can review, edit, and export — this is prompt-based generation, not OCR/image extraction.

📋 Full feature list

Feature	Description
✍️ Manual Invoice Builder	Create invoices from scratch
🤖 Prompt-based AI Invoice Generation	Generate invoices from natural language prompts using Gemini AI
✏️ Edit Generated Invoice	Modify any AI-generated fields before saving
📄 PDF Export	Download professional invoices
🔐 Clerk Authentication	Secure user accounts
🔍 Search & Filters	Find invoices instantly
📊 Invoice Dashboard	Manage all invoices in one place
🖼️ Logo, Stamp & Signature	Customize invoice branding
🧮 Automatic Calculations	Totals and taxes calculated automatically
📱 Responsive Design	Works across desktop and mobile
🛡️ Protected APIs	Every mutating endpoint requires an authenticated session
🗄️ MongoDB Atlas	Invoices and profiles persisted in the cloud

🖼️ Screenshots

Home	Features

Pricing	Footer

Dashboard	Create Invoice

Generate with AI	Invoice Preview

Invoice Management	Business Profile

🧰 Tech Stack

Layer	Technologies
Frontend
Backend
Database
Authentication
AI
File Upload
Deployment

_{Each badge links to that technology's official site.}

🏗️ Architecture

flowchart TD
    U(👤 Users) --> FE[React App · Netlify]
    FE --> API[Express.js API · Render]
    API --> EXT[Clerk Auth + Gemini AI]
    API --> DB[(MongoDB Atlas)]
    API --> UP[(uploads/ · logo, signature, stamp)]

    classDef edge fill:#EEF2FF,stroke:#6366F1,stroke-width:1.5px,color:#312E81;
    classDef compute fill:#F5E8FF,stroke:#A855F7,stroke-width:1.5px,color:#581C87;
    classDef store fill:#FDE8FF,stroke:#C026D3,stroke-width:1.5px,color:#701A75;
    classDef user fill:#FFF1F5,stroke:#EC4899,stroke-width:1.5px,color:#831843;

    class U user;
    class FE edge;
    class API compute;
    class DB,UP store;
    class EXT compute;

Frontend: React build deployed to Netlify, served over its global CDN. Backend: Express.js API deployed as a web service on Render. Data & AI: Clerk handles auth, Gemini generates structured invoices from natural-language prompts, MongoDB Atlas persists everything. Files: logo/signature/stamp uploads are handled by the Express API via Multer.

🚀 Deployment

Ledgerly AI is deployed as a deployed full-stack application:

Layer	Platform
Frontend	Netlify
Backend	Render
Database	MongoDB Atlas
Authentication	Clerk
AI Integration	Google Gemini API

Deploy it yourself

Frontend (Netlify)

Connect the repository, set the base directory to frontend/.
Build command: npm run build · Publish directory: dist.
Add VITE_API_URL and VITE_CLERK_PUBLISHABLE_KEY as environment variables.

Backend (Render)

Create a new Web Service pointed at the backend/ directory.
Build command: npm install · Start command: npm run dev (or your production start script).
Add the backend environment variables listed below.

Database (MongoDB Atlas)

Whitelist Render's outbound IP ranges (or 0.0.0.0/0 for early testing) and copy the connection string into MONGODB_URI.

📁 Project Structure

AI SAAS Invoice Generator/
├── backend/
│   ├── controllers/
│   ├── db/
│   ├── middleware/
│   ├── models/
│   ├── routes/
│   ├── services/
│   ├── uploads/
│   └── utils/
│
├── frontend/
│   ├── public/
│   └── src/
│       ├── assets/
│       │   └── GenerateBtn/
│       ├── components/
│       └── pages/
│
├── readme/
├── README.md
└── package.json

🚀 Installation

git clone https://github.com/LovelySharma-dev/ledgerly-ai.git
cd ledgerly-ai

cd backend
npm install
cp .env.example .env
npm run dev          # http://localhost:3000

cd ../frontend
npm install
cp .env.example .env
npm run dev          # http://localhost:5173

⚙️ Environment variables

# backend/.env
PORT=5000
# Development
BASE_URL=http://localhost:3000
# Production
BASE_URL=https://ledgerly-ai.onrender.com
JWT_SECRET=your_secret
MONGODB_URI=your_mongodb_atlas_uri
CLERK_SECRET_KEY=your_clerk_secret_key
CLERK_PUBLISHABLE_KEY=your_clerk_publishable_key
GEMINI_API_KEY=your_gemini_api_key
CLIENT_URL=http://localhost:5173

# frontend/.env
VITE_API_URL=http://localhost:3000/api
VITE_CLERK_PUBLISHABLE_KEY=your_clerk_publishable_key

🔌 Core API endpoints

Method	Endpoint	Purpose
`POST`	`/api/businessProfile`	Create a business profile
`PUT`	`/api/businessProfile/:id`	Update an existing business profile
`GET`	`/api/businessProfile/me`	Get the authenticated user's business profile
`POST`	`/api/invoice`	Create a new invoice
`GET`	`/api/invoice`	Retrieve all invoices
`GET`	`/api/invoice/:id`	Retrieve a single invoice
`PUT`	`/api/invoice/:id`	Update an existing invoice
`DELETE`	`/api/invoice/:id`	Delete an existing invoice
`POST`	`/api/ai/generate`	Generate invoice data using AI

🌐 Live Demo


Frontend	https://legderlyai.netlify.app
Backend API	https://ledgerly-ai.onrender.com

📄 License

This project is intended for educational and portfolio purposes.

Highlights

AI-powered invoice generation using Gemini
Manual invoice creation and editing
Business profile management
PDF invoice export
Clerk authentication
Search and invoice management
Responsive dashboard
Cloud deployment with Netlify, Render, and MongoDB Atlas

💡 Why Ledgerly AI

Creating invoices manually is repetitive and time-consuming.

Ledgerly AI explores how Large Language Models can transform natural language into structured business documents. The project combines AI-powered invoice generation with modern authentication, cloud deployment, PDF generation, and a scalable backend architecture to simulate a production-ready SaaS application.