Billflow is a open source self-hosted billing and invoicing software designed for businesses of all sizes. BillFlow is built with Django (python) and Angular (TypeScript) Frameworks.

To install Billflow, follow these steps:

1. Clone the repository using the following command:
   git clone https://github.com/Einswilli/billflow.git
2. Change into the cloned directory:
   cd billflow
3. Run the projects:
   

• a. using Docker:
  docker-compose up --build -d
  
  
• b. using classic commands:

  • i. Frontend
    

    • navigate into frontend folder: cd frontend
      
    • Install requirements: npm install
      
    • Run the project: ng serve
      

  • ii. Backend
    

    • navigate into backend folder: cd backend
      
    • install pipenv: pip install pipenv
      
    • Activate the virtual environment: pipenv shell
      
    • Install requirements: pipenv install
      
    • Run the project: python manage.py runserver 12000
      

4. Open http://localhost:4200 in your browser 🎉

You need authentication to access the dashboard. You can use the following credentials to login:

• Email: exemple@exemple.com
• Phone number: +22890000102
• Password: password@123

The authentication is email or phone number based.

Made with ❤️ by #Einswilli