Invoxify

Simplify Your Invoicing

Invoxify is a free, web-based invoice management tool built by Ainbae that helps you create, send, and track invoices effortlessly. Whether you're a freelancer or a small business owner, Invoxify streamlines your invoicing process with professional PDF invoice generation, automated email integration, payment reminders, draft saving, and revenue analytics.

Table of Contents

• Features
• Demo
• Getting Started
• Installation
• Usage
• Built With
• Contributing
• License
• Contact

Features

• Professional Invoice Creation: Quickly design and generate sleek invoices customized with your logo and business details.
• Email Integration: Send invoices directly to your clients with PDF attachments for seamless communication.
• Payment Reminders: Send reminders to ensure you get paid on time.
• Draft and Save: Save unfinished invoices as drafts and finalize them when you're ready.
• Revenue Analytics: Monitor your total revenue with interactive graphs and charts.
• Download Invoices: Easily download your invoices as high-quality PDFs for offline access or record-keeping.

Demo

Check out our live demo: Invoxify Live

Getting Started

To get started with Invoxify, simply sign up for a free account and start managing your invoices in minutes!

Installation

If you'd like to run Invoxify locally, follow these steps:

1. Clone the repository:

   git clone https://github.com/yourusername/invoxify.git
   cd invoxify

2. Install dependencies

   pnpm install

3. Create a .env file:

   AUTH_SECRET=
   
   EMAIL_SERVER_USER=
   EMAIL_SERVER_PASSWORD=
   EMAIL_SERVER_HOST=
   EMAIL_SERVER_PORT=
   EMAIL_FROM=
   
   MAILTRAP_TOKEN=
   
   DATABASE_URL=
   
   AUTH_GITHUB_ID=
   AUTH_GITHUB_SECRET=
   
   AUTH_GOOGLE_ID=
   AUTH_GOOGLE_SECRET=
   
   AUTH_FACEBOOK_ID=
   AUTH_FACEBOOK_SECRET=
   
   AUTH_TRUST_HOST=true

   Where to get these values:

   • AUTH_SECRET: You can generate this via the official Auth.js CLI running:

     npx auth secret

   • EMAIL_SERVER_*: These are provided by your email service provider. For development, consider using Mailtrap.

   • MAILTRAP_TOKEN: Available from your Mailtrap account dashboard after signing up.

   • DATABASE_URL: Your database connection string – you can get this from Neon.tech.

   • AUTH_GITHUB_ID and AUTH_GITHUB_SECRET: Register your application in GitHub Developer Settings.

   • AUTH_GOOGLE_ID and AUTH_GOOGLE_SECRET: Obtain these by registering your app on the Google Developer Console.

   • AUTH_FACEBOOK_ID and AUTH_FACEBOOK_SECRET: Register your app on Facebook for Developers.

4. Connect your DataBase: Connect your Neon Database with Prisma.

   npx prisma generate
   pnpm dlx prisma db push
   pnpm dlx prisma studio

5. Start the development server:

   pnpm run dev

6. Open your browser and navigate to:

   http://localhost:3000
   

Adjust these instructions based on your actual tech stack and environment.

Environment Variables

The application uses environment variables to manage configuration. Ensure you set them up in your .env file as shown above. This file is critical for:

• Authentication and Security: (AUTH_SECRET)
• Email Service: (EMAIL_SERVER_USER, EMAIL_SERVER_PASSWORD, EMAIL_SERVER_HOST, EMAIL_SERVER_PORT, EMAIL_FROM, MAILTRAP_TOKEN)
• Database Connection: (DATABASE_URL - Obtain from Neon.tech)
• Social Authentication: (AUTH_GITHUB_ID, AUTH_GITHUB_SECRET, AUTH_GOOGLE_ID, AUTH_GOOGLE_SECRET, AUTH_FACEBOOK_ID, AUTH_FACEBOOK_SECRET)
• Trust Configuration: (AUTH_TRUST_HOST)

Usage

Once running, you can:

• Create new invoices using the dashboard.
• Customize and send invoices as professional PDFs.
• Monitor your invoicing and payment statuses.
• Analyze revenue with interactive graphs.

Built With

Contributing

Contributions are welcome! If you'd like to contribute to Invoxify, please fork the repository and create a pull request. For major changes, please open an issue first to discuss what you would like to change.

See the CONTRIBUTING.md file for more details.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contact

For support or inquiries, please contact us at [email protected].

---

Invoxify is a product by Ainbae – making invoicing simple so you can focus on growing your business!