Skip to content

Repository files navigation

VO Force ProBill

Africa's First Voice Actors Invoicing Platform

About

VO Force ProBill is a comprehensive invoicing and financial management platform designed specifically for voice actors in Africa. It streamlines invoice creation, receipt tracking, and provides real-time profit & loss analysis.

Features

  • ✅ Invoice & Receipt Management
  • ✅ Automated Cost Tracking with Auto Expenses
  • ✅ Real-time Profit & Loss Dashboard
  • ✅ Company Profile Management
  • ✅ Service/Product Catalog with Cost & Selling Prices
  • ✅ File Upload (Logo, Documents)
  • ✅ Email Integration for Invoice/Receipt Delivery

Tech Stack

  • Frontend: Next.js 14 + React + TypeScript + Tailwind CSS
  • Backend: Node.js + Express
  • Database: PostgreSQL
  • Hosting: Vercel (free tier)
  • Branding: Red color scheme (#FF3B30)

Getting Started

Prerequisites

  • Node.js 18+
  • npm or yarn
  • PostgreSQL database

Installation

  1. Clone the repository

  2. Install dependencies:

    npm install
  3. Create a .env.local file with:

    DATABASE_URL=postgresql://user:password@localhost:5432/vo_force_probill
    JWT_SECRET=your_jwt_secret_key
    NEXT_PUBLIC_API_URL=http://localhost:3000
    
  4. Run the development server:

    npm run dev
  5. Open http://localhost:3000 in your browser

Backend Setup

To run the Express backend:

npm run backend-dev

Backend runs on http://localhost:5000 by default.

Project Structure

vo-force-probill/
├── src/
│   ├── app/              # Next.js app router pages
│   ├── components/       # Reusable React components
│   └── lib/              # Utility functions & helpers
├── backend/
│   ├── routes/           # Express API routes
│   ├── controllers/      # Business logic
│   ├── db/               # Database setup & migrations
│   └── middleware/       # Express middleware
├── public/               # Static assets
└── package.json

Development

Frontend Development

npm run dev

ESLint & Type Checking

npm run lint

Build for Production

npm run build
npm start

Database

The application uses PostgreSQL. Database schema includes:

  • users - User accounts
  • companies - Company profiles
  • services - Services/products offered
  • invoices - Invoice records
  • receipts - Payment receipts
  • expenses - Expense tracking
  • files - Media uploads

Contributing

Contributions are welcome! Please follow the code style guidelines and create pull requests with clear descriptions.

License

Proprietary - VO Force ProBill

Support

For support, contact: support@voforceprobi ll.com

About

Africa's First Voice Actors Invoicing App

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages