https://github.com/nevin100/invoicer-v1
Invoicer v1 is a modern, full-stack monolithic invoice and finance management platform. The platform is designed to help individuals, freelancers, and small businesses manage invoices, expenses, clients, payments, and analytics from responsive dashboards.
https://github.com/nevin100/invoicer-v1
app-router-nextjs bcrypt-nodejs cookies docker exceljs express github-actions mongodb mongoose nextjs razorpay redis redux rtk-query shadcn-ui tailwidcss typescript vercel-deployment zod-validation
Last synced: 7 days ago
JSON representation
Invoicer v1 is a modern, full-stack monolithic invoice and finance management platform. The platform is designed to help individuals, freelancers, and small businesses manage invoices, expenses, clients, payments, and analytics from responsive dashboards.
- Host: GitHub
- URL: https://github.com/nevin100/invoicer-v1
- Owner: Nevin100
- Created: 2025-03-16T14:37:03.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2026-05-14T16:24:42.000Z (16 days ago)
- Last Synced: 2026-05-14T18:34:37.333Z (16 days ago)
- Topics: app-router-nextjs, bcrypt-nodejs, cookies, docker, exceljs, express, github-actions, mongodb, mongoose, nextjs, razorpay, redis, redux, rtk-query, shadcn-ui, tailwidcss, typescript, vercel-deployment, zod-validation
- Language: TypeScript
- Homepage: https://invoicer.nevinbali.me
- Size: 7.98 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🧾 Invoicer v1
> ⚡ A modern full-stack + GenAI - invoice & finance management platform
---
# 📌 Overview
**Invoicer v1** is a production-structured financial management system designed for freelancers, startups, and small businesses.
It provides a complete workflow for:
- Invoice lifecycle management
- Expense tracking & categorization
- Client management
- Secure online payments
- Financial analytics dashboard
- Structured data exports
- Ai Eval Reports + Insights using Tavilly API + Groq API
The architecture is designed to evolve into a scalable SaaS-ready financial operating system.
---
# 🏗️ Architecture
| Layer | Technology |
|-------|------------|
| Frontend | Next.js (App Router), React, TypeScript |
| Backend | Next.js API Routes |
| Database | MongoDB + Mongoose |
| State Management | Redux Toolkit |
| Validation | Zod |
| Authentication | JWT |
| Payments | Razorpay |
| CI/CD Pipelines | Github Actions |
| Deployment | Vercel |
| Containerization | Docker |
| Caching | Redis |
---
# 📊 Development Status
| Module | Status |
|--------|--------|
| Authentication (JWT) | ✅ Completed |
| Dashboard UI | ✅ Completed |
| Expense Management | ✅ Completed |
| Client Management | ✅ Completed |
| Razorpay Integration | ✅ Completed |
| Excel Export | ✅ Completed |
| Financial Analytics | ✅ Completed |
| Invoice Creation | ✅ Completed |
| Invoice Emailing | ✅ Completed |
| Inventory Management | ✅ Completed |
| Google OAuth Integration | ✅ Completed |
| SAAS Service Credit System + Services Launch | ✅ Completed |
| AI Insights | ✅ Completed |
| AI Report Generation | ✅ Completed |
| AI Export Feature + History | ✅ Completed |
---
# ✨ Features
## 🔐 Authentication & Security
- JWT-based authentication
- Password hashing using bcrypt
- Secure API routes
- User-scoped database access
- Zod schema validation
- Middleware protection
---
## 👥 Client Management
- Add, edit, delete clients
- Client-linked invoices
- Client-linked expenses
- Structured relational references
---
## 💸 Expense Management
- Add / edit / delete expenses
- Category-based tracking
- Date-based filtering
- Monthly aggregation logic
- Top spending category detection
- Dashboard integration
- Excel export functionality
---
## 🧾 Invoice System
- Dynamic invoice creation
- Auto-filled client billing section
- Multiple line items
- Tax & discount calculations
- Recurring invoice flag support
- Automatic invoice number generation
- Payment status tracking (Paid / Pending)
---
## 💳 Razorpay Payment Integration
- Secure order creation
- Payment verification
- Success & failure handling
- Invoice status auto-update
---
## 📊 Financial Analytics
- Monthly expense trends
- Client growth metrics
- Aggregated totals
- Interactive charts (Recharts)
- Responsive dashboard
- Skeleton loaders & empty states
---
## 📤 Data Export
- Export expenses to Excel
- Structured spreadsheet output
- Accounting-ready formatting
---
## 📱 Responsive Design
- Mobile-first layout
- Sidebar navigation system
- Adaptive dashboards
- Optimized for Desktop / Tablet / Mobile
---
## 📱 AI capabilities:
- Spending pattern analysis
- Financial anomaly detection
- Predictive cash-flow insights
Goal: Transform Invoicer into a smart financial insight assistant.
---
# 🛠️ Tech Stack
### Frontend
- Next.js
- React
- TypeScript
- Tailwind CSS
- Recharts
- Radix UI
- Lucide Icons
### Backend
- Next.js API Routes
- MongoDB
- Mongoose
- JWT
- Zod
- Bcrypt
### State & Utilities
- Redux Toolkit
- React Hook Form
- Axios
- ExcelJS
- File Saver
- Date-Fns
---
# 📷 Images:
# ⚙️ Installation & Setup
```bash
# Clone repository
git clone https://github.com/Nevin100/Invoicer-v1.git
# Navigate to project
cd Invoicer-v1
# Install dependencies
npm install
# Create.env file then paste the redentials required and then run
npm run dev
```