🧾 Invoicer v1

/>

⚡ A modern full-stack + GenAI - invoice & finance management platform
🚧 Currently ~95% complete and under active development

---

📌 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

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	Dcoker
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	🚧 In Progress
AI Report Generation	🚧 In Progress

Overall Completion: ~95%

---

✨ 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

---

Future Scope (AI-First Vision)

Planned AI capabilities:

• Automatic expense categorization
• Spending pattern analysis
• Financial anomaly detection
• Predictive cash-flow insights
• Intelligent invoice reminders

Goal: Transform Invoicer into a smart financial 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

# 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