What is Bill Generator? 🤔
Bill Generator is a web application designed to automate the process of invoice creation. It provides a user-friendly interface where users can input the necessary details such as address, bill-to name, description, quantity, unit price, and more to generate a professional-looking invoice.
The application is built using modern web technologies, including Next.js API serverless functions, and follows best practices for web development. It's designed to be responsive, so it works well on both desktop and mobile devices.
Whether you're a freelancer needing to bill clients, a small business owner looking for a more efficient way to handle invoicing, or just someone who wants to simplify the process of creating invoices, Bill Generator can help.
To start using Bill Generator, simply navigate to the main page, fill in the required fields, and click the "Generate Invoice" button. Your invoice will be created and ready to be sent in no time.
Please note that the application is still in development, and more features are planned for future releases. If you have any suggestions or feedback, feel free to contribute to the project.
See you there!
BillGenerator is built using the following technologies:
- Next.js - a framework for building server-rendered React applications
- MongoDB - a NoSQL database
- Tailwind CSS - a utility-first CSS framework
- Vercel - a cloud platform for static sites and Serverless Functions
- TypeScript - a typed superset of JavaScript that compiles to plain JavaScript
- NextAuth Js - an authentication library for Next.js
Bill Generator is fully on your computer and requires each dependency (for example MongoDB) to be installed in order to start the local development.
- Mongodb
- Follow the instructions in the MongoDB setup guide to set up your MongoDB Atlas database.
- Google Cloud
- Follow the instructions in the Google Cloud setup guide to set up your Google Cloud project.
Follow these steps to create a fork of this repository and then clone it to your local machine.
git clone https://github.com/<github user>/BillGenerator.git
After cloning move into the cloned repo:
cd bill-generator
If you have node already installed in your computer you can avoid this step. To install node
download the installer from their site. Please download the lates and LTS version.
pnpm
is a package manager that is used to install all dependencies needed.
If you would like to read more about pnpm
you can visit their documentation.
The best way to install pnpm
for this project is by using Corepack, a new feature bundled with Node.
Install pnpm with the following commands (there are more ways to install 'pnpm' if you prefer to use a different method please visit pnpm's installation page):
npm install -g pnpm
Use the following command to create a local .env
file. Then open the new file (.env
) to make any changes required in the document.
cp .env.example .env
Once you have node
, pnpm
installed, please run the following command to install all dependencies:
pnpm install
After running the command above, you should see a node_modules
folder in your project root. This is where all the dependencies are installed. At this point you can run the project locally using the following command:
pnpm dev
Once you run this command, a local server is running at http://localhost:3000 any changes that you make to the code will be reflected on the browser automatically.