mokuappio / serverless-invoices

Create and manage invoices in your browser. Serverless Invoices is a free invoicing tool for freelancers and small businesses. Made with Vue.js.

Serverless Invoices by Moku

Serverless Invoices is a free invoicing tool for freelancers and small businesses.

It is open-source and easily extendable. You can use it as a starter kit for more complex systems. Implement your own features, localization, styling or integrate with various other systems and API-s.

Run it locally or host it yourself.

You can always use the latest free version at invoices.mokuapp.io

Built with Vue.js and Bootstrap

Features

• Truly serverless - data stored in your browser only, no network requests
• No hosting required - works locally
• Invoices
  • Create & manage invoices
  • Track invoices by status and due date
  • Multiple custom taxes
  • Print to PDF
  • Customizable logo and template, CSS
• Bank accounts
• Clients
  • Create & manage clients
  • Custom fields
• Company details
  • Edit default company details
  • Custom fields
  • Default taxes
• Export & import json data
• Dark and light mode!
• Multilingual
• PWA support
• Ready-to-go backend adapters
  • Browser Storage
  • Wordpress
  • Woocommerce (coming soon)
  • Google Drive (coming soon)
  • Custom HTTP API

Project setup

Requires node 16.18

npm install

Create app config

Create an app.config.js which can be edited for custom settings.

cp src/config/app.config.example.js src/config/app.config.js

Compiles and hot-reloads for development

npm run serve

Compiles and minifies for production

npm run build

Lints and fixes files

npm run lint

Run with Docker

It is necessary to install Docker before running the following commands.

git clone https://github.com/mokuappio/serverless-invoices.git
cd serverless-invoices.git
docker build . -t mokuappio/serverless-invoices
docker run -p 80:8080 -d --rm mokuappio/serverless-invoices

It is possible to add an alias in your .bashrc/.zshrc file to launch the app on the fly.

echo "alias serverless-invoices='docker run -p 80:8080 -d --rm mokuappio/serverless-invoices'" >> ~/.zshrc
source ~/.zshrc
serverless-invoices

Topics

• invoices management
• invoicing solution
• invoice maker
• invoice generator

Affiliates and sponsors

ZONE offers fast and secure web hosting, spam free email, cheap domains and quality support.

Get 50% off your first year with the code ELEVATE

• Get your web, email and domain
• Already have a domain? Get only web and email

MOKU offers simple time tracking, task management and automated invoicing for ambitious dev teams and freelancers.

• Get your free trial

serverless-invoices's Issues

Misses footer text

This application is one of the finest local invoice generators for browsers.

Yet it misses an important feature, at least for the German market:

• As an invoice creator, I need to add a footer message to the invoice, in order to present my organisation's registration and tax numbers.

Everything else is here, but these details don't need to come within the notes field, why another (multi-line?) field (inbetween the bank account details and the contact information?) is suggested.

See https://invoice-generator.com/ for an example.

Customized CSS doesn't carry over into downloaded invoices

I am using the "installed version" of the Moku app. I am not sure if this is where I should post this issue. I made a tweak to the CSS through the customize option on an invoice, but it doesn't show up when I download the PDF.

I am adding/overriding:
`.col-8 {
flex: 0 0 50%;
max-width: 50%;
}

.col-4 {
flex: 0 0 50%;
max-width: 50%;
}`
because my email and website are long enough that it wont right justify and it looks very sloppy.

This is the output:

Interestingly, the serverless online version displays the contact information at the bottom correctly until I download the PDF. But the CSS customization DOES show up in the PDF from there.
Outside of this, I am loving the app. It does exactly what I need.

French translations not available

How to add Tax withheld ?

Label customization

Hi,

There is in plan to add a label customization? For example, to modify "Invoice", "Item", "Quantity", "Unit", "Price", "Issued at", "Due at", "Date", and so on.

Maybe it is possible to have a JSON for each language, and a default template so each one could edit that JSON in order to have it in their language, or to have the possibility to add multiple JSONs in order to switch fast between languages.

Thanks! :)

Local install Error on first run

Hi there, I just got following Error after npm install on my local machine (OSX12.01):

This dependency was not found:
* @/config/app.config in ./src/router.js, ./node_modules/cache-loader/dist/cjs.js??ref--12-0!./node_modules/babel-loader/lib!./node_modules/cache-loader/dist/cjs.js??ref--0-0!./node_modules/vue-loader/lib??vue-loader-options!./src/components/TheFooter.vue?vue&type=script&lang=js& and 4 others
To install it, you can run: npm install --save @/config/app.config

Tried on node 10 & 14. When I run the suggested command to install the missing dependency, I got this message:

error code ENOLOCAL
error Could not install from "@/config/app.config" as it does not contain a package.json file.

Do you have any suggestions?
Thank you! Chris

Issued at / Due date Customization / Edit

Hi,

On each invoice you have a code, issued at, due at and late fee.

There is a way to eliminate 'Issued at' / 'Due at' and insted to have just 'Date'?

Maybe if there was an EDIT like on 'Client' from where you can edit those too?

Thanks! :)

why BankAccount linking to client

just trying to understand what is the context for the bank account linked to client.
which bank account of client is needed in invoice.

i am thinking may be company/team account needed in invoice.
my understanding is company is invoice created by him for the work to the client.
so company share there bank information of his to transact for the work.

Duplicating invoices

Is there a way to duplicate invoices? I would be happy to take a past invoice, duplicate it, make a few edits and be done.

If not, would you be open to adding it?
I'm not familiar with the codebase, but could take a crack at it if that's more convenient.

`npm install` fails on fresh clone

When I run npm install after a fresh clone, the install fails. Seems to be something to do with compiling node-sass.

npm --version: 8.5.5
node --version: v16.15.0

npm install: log.txt

I had a play around upgrading node-sass but it broke a few peer dependencies. I'm pretty unfamiliar with the Vue ecosystem so got out of my depth quite quickly sorry.

I need to updates file upload field as a signature

I need to updates file upload field as a signature but file_upload logo stop working its seems like clashing please help ,me out I need to update invoice with signature file add on same invoice detail page but getting error

Rounding issues

Steps: Add line qty=8.33, price=49.5

Expected result: total is 412.34

Current result: 412.33