📄 Invoicely — Smart Invoicing & Effortless Business Management 🚀

Welcome to Invoicely, a powerful, user-friendly platform designed for modern businesses. From invoices to e-way bills, product catalogs to vendor lists, everything is organized in one seamless dashboard — helping you build professionalism, maintain compliance, and scale your brand effortlessly.

Whether you're handling a single business or managing multiple companies, Invoicely offers the flexibility and control you need — without the complexity.

---

💡 Why Invoicely?

Because billing shouldn’t feel like a chore.
Invoicely transforms paperwork into productivity with:

✅ Automated invoice creation
✅ Seamless GST & e-way bill generation
✅ Multi-company management from a single login
✅ Professionally branded documents
✅ Secure and searchable record-keeping

---

🛠️ Core Features

Module	Description
🧾 Invoices & Sales Bills	Generate GST-compliant invoices in seconds with professional templates
🚚 E-Way Bill Integration	Create and manage transport documents efficiently
📦 Product / Service Catalog	Maintain stock details with pricing, taxes, and unit tracking
🧑‍🤝‍🧑 Vendors & Customers	Centralized contact management for suppliers and buyers
🧑‍💼 Multi-Company Management	Users can switch and operate between multiple registered companies
📊 Reports & Analytics	View insights on sales, dues, and growth metrics (coming soon)

---

🧠 Who Is It For?

• 🏢 Small & Medium Enterprises
• 🛒 Retailers & Wholesalers
• 🚛 Transport & Logistics Providers
• 📦 Manufacturing & Trading Firms
• 🧑‍💻 Freelancers & Service Providers

---

🗂️ Nx Monorepo Folder Structure

/INVOICELY  # Nx Monorepo Root

├── apps/
│   ├── server/          # Backend Application (NestJS)
│   │   └── src/
│   │       ├── app.module.ts
│   │       ├── main.ts
│   │       └── app/           # Feature Modules
│   │           ├── invoice/
│   │           │   ├── invoice.controller.ts
│   │           │   ├── invoice.service.ts
│   │           │   ├── invoice.module.ts
│   │           │   └── dto/
│   │           │       ├── create-invoice.dto.ts
│   │           │       └── update-invoice.dto.ts
│   │           ├── product/
│   │           ├── vendor/
│   │           ├── eway-bill/
│   │           └── company/
│   │           └── database/
│   │           └──└── models/
│   │           └──└──└── index.ts
│   │           └──└──└── company.model.ts
│   │           └──└──└── base.model.ts
│   │           └──└── database.module.ts/ # connection of database
│   ├── web/         # Frontend Application (Next.js, In Progress)
│   │   └── app/ # Application Main Page Routing
│   │       └── (dashboard) # Protected route
│   │       └── └── page.tsx
│   │       └── └── layout.tsx
│   │       └── └── companies
│   │       └── └── └── [id]
│   │       └── └── └── └── vendors
│   │       └── └── └── └── └── page.tsx
│   │       └── └── └── └── page.tsx
│   │       └── └── └── page.tsx
│   │       views/ # All common components logic, store, utils
│   │       public/ # All media such as images, css, js
│   │       libs/ # axios instance, api body defined, toast setup
│
├── libs/ or shared/                # Shared modules (utilities, DTOs, interfaces, constants)
│   ├── constants/
│   ├── types/
│   └── utils/
│   └── api-interfaces/
│   └── interfaces/
│
├── nx.json
├── workspace.json
├── package.json
└── tsconfig.base.json

🔧 Tech Stack
| Layer            | Tech Used                                                        |
| ---------------- | ---------------------------------------------------------------- |
| Backend          | NestJS (Node.js + TypeScript), MongoDB for database              |
| Frontend         | Next.js (React framework, setup-in-progress)                           |
| Monorepo Tooling | Nx Workspace for project orchestration and shared libraries      |
| Shared Logic     | `shared` folder for DTOs, utility functions, and interfaces, components, styles |

🚀 Development Setup

# Install dependencies
pnpm install

# Run backend app
nx serve server

# Run frontend app (once available)
nx dev web

# Generate new module/service/controller for backend
nx g @nrwl/nest:module <module-name> --project=server
nx g @nrwl/nest:controller <controller-name> --project=server
nx g @nrwl/nest:service <service-name> --project=server
⚠️ Make sure your MongoDB instance is running and .env variables are set for database connection.

🤝 Contributing

Invoicely is continuously evolving.

This is an Open-Source repository, and contributions are always welcome! If you find an issue, please create a new issue under the "Issues" section. To contribute code, fork the repository and submit a pull request. Your contributions will help make this a valuable resource for the community!

1. Fork the repository
2. Create a new branch: git checkout -b feature/my-feature
3. Make your changes
4. Commit your changes: git commit -am 'Add new feature'
5. Push to the branch: git push origin feature/my-feature
6. Open a Pull Request

✨ Contributors

Thanks goes to these wonderful people (emoji key):

<>

Om J Patel 💻 🔣 🖋 📖 🤔 🚧 🔬

Chetan Nada 💻 🤔 🔬 🎨 🖋

🤝 Let's Connect