Free & Open-Source Invoice Generator - No Sign-Up, No Ads, Instant PDF Export, 100% In-Browser, and Fully Customizable Templates.
TypeScript fintechinvoiceinvoice-generatorinvoice-pdfinvoice-templateinvoicesnextjsopen-sourcequotesreactreact-pdf-rendererself-hostedshadcn-uitailwindcsstypescript
import dayjs from "dayjs";
import {
getDefaultInvoiceNumberLabel,
INVOICE_PDF_TRANSLATIONS,
} from "../(main)/(app)/pdf-i18n-translations/pdf-translations";
import {
SUPPORTED_CURRENCIES,
SUPPORTED_INVOICE_PDF_LANGUAGES,
SUPPORTED_TEMPLATES,
DEFAULT_DATE_FORMAT,
type InvoiceData,
type SupportedTemplates,
type SellerData,
type BuyerData,
} from "../schema";
/**
* Current date in YYYY-MM-DD format
*
* Used as default **date of issue**
*/
const TODAY = dayjs().format("YYYY-MM-DD");
/**
* First day of current month in YYYY-MM-DD format
*
* Used as default date of **service period start**
*/
const FIRST_DAY_OF_MONTH = dayjs().startOf("month").format("YYYY-MM-DD");
/**
* Last day of current month in YYYY-MM-DD format
*
* Used as default date of **service period end** and **date of service**
*/
const LAST_DAY_OF_MONTH = dayjs().endOf("month").format("YYYY-MM-DD");
/**
* Payment due date (14 days from today) in YYYY-MM-DD format
*
* Used as default **payment due date**
*/
const PAYMENT_DUE = dayjs(TODAY).add(14, "days").format("YYYY-MM-DD");
const EUR = SUPPORTED_CURRENCIES[0];
const EN = SUPPORTED_INVOICE_PDF_LANGUAGES[0];
const DEFAULT_TEMPLATE = SUPPORTED_TEMPLATES[0];
/**
* Default invoice number value computed at call time.
* Format: 1/MM-YYYY (e.g., 1/03-2024)
*
* Used as default **invoice number** when creating a new invoice
*
* @param date - Instant the number is derived from. Defaults to `dayjs()`, which
* follows the process timezone — server callers pass an explicit zoned instant.
*/
export function getInvoiceDefaultNumberValue(date: dayjs.Dayjs = dayjs()) {
return `1/${date.format("MM-YYYY")}` as const;
}
/**
* Default seller data
*
* This is the default data that will be used if the user doesn't provide their own data
*/
export const DEFAULT_SELLER_DATA = {
name: "Seller name",
address: "Seller address",
vatNo: "Seller vat number",
vatNoLabelText: "VAT no",
vatNoFieldIsVisible: true,
email: "[email protected]",
emailFieldIsVisible: true,
accountNumber: "Seller account number",
accountNumberFieldIsVisible: true,
swiftBic: "Seller swift bic",
swiftBicFieldIsVisible: true,
// field for additional notes about the seller (not visible by default)
notes: "",
notesFieldIsVisible: true,
} as const satisfies Omit<SellerData, "id">;
/**
* Default buyer data
*
* This is the default data that will be used if the user doesn't provide their own data
*/
export const DEFAULT_BUYER_DATA = {
name: "Buyer name",
address: "Buyer address",
vatNo: "Buyer vat number",
vatNoLabelText: "VAT no",
vatNoFieldIsVisible: true,
email: "[email protected]",
emailFieldIsVisible: true,
// field for additional notes about the buyer (not visible by default)
notes: "",
notesFieldIsVisible: true,
} as const satisfies Omit<BuyerData, "id">;
/**
* Initial invoice data
*
* This is the initial data that will be used when the user first opens the app or clears the invoice data
*/
export const INITIAL_INVOICE_DATA = {
language: EN,
currency: EUR,
template: DEFAULT_TEMPLATE,
logo: "",
stripePayOnlineUrl: "",
invoiceNumberObject: {
label: `${INVOICE_PDF_TRANSLATIONS[EN].invoiceNumber}:`,
value: getInvoiceDefaultNumberValue(),
},
dateOfIssue: TODAY,
dateOfServiceStart: FIRST_DAY_OF_MONTH,
dateOfService: LAST_DAY_OF_MONTH,
servicePeriodFieldIsVisible: false,
dateOfServiceFieldIsVisible: true,
servicePeriodLabelText: INVOICE_PDF_TRANSLATIONS[EN].servicePeriod,
dateOfServiceLabelText: INVOICE_PDF_TRANSLATIONS[EN].dateOfService,
dateFormat: DEFAULT_DATE_FORMAT,
invoiceType: "",
invoiceTypeFieldIsVisible: true,
seller: DEFAULT_SELLER_DATA,
buyer: DEFAULT_BUYER_DATA,
items: [
{
invoiceItemNumberIsVisible: true,
name: "Item name",
nameFieldIsVisible: true,
typeOfGTU: "",
typeOfGTUFieldIsVisible: false, // we hide this field by default because it's not always needed
amount: 1,
amountFieldIsVisible: true,
unit: "service",
unitFieldIsVisible: true,
netPrice: 0,
netPriceFieldIsVisible: true,
vat: "NP",
vatFieldIsVisible: true,
netAmount: 0,
netAmountFieldIsVisible: true,
vatAmount: 0.0,
vatAmountFieldIsVisible: true,
preTaxAmount: 0,
preTaxAmountFieldIsVisible: true,
discountType: "percentage",
discountValue: 0,
discountLabel: "",
discountAmount: 0,
},
],
total: 0,
paymentMethod: "wire transfer",
paymentDue: PAYMENT_DUE,
notes: "Reverse charge",
notesFieldIsVisible: true,
qrCodeData: "",
qrCodeDescription: "",
qrCodeIsVisible: true,
vatTableSummaryIsVisible: true,
paymentMethodFieldIsVisible: true,
personAuthorizedToReceiveName: "",
personAuthorizedToReceiveFieldIsVisible: true,
personAuthorizedToIssueName: "",
personAuthorizedToIssueFieldIsVisible: true,
taxLabelText: "VAT",
} as const satisfies InvoiceData;
/**
* Returns initial invoice data with a freshly computed default invoice number.
* Use when resetting form state at runtime (avoids stale month on long-lived tabs).
*/
export function getInitialInvoiceData(
template: SupportedTemplates = DEFAULT_TEMPLATE,
) {
return {
...INITIAL_INVOICE_DATA,
template,
invoiceNumberObject: {
...INITIAL_INVOICE_DATA.invoiceNumberObject,
label: getDefaultInvoiceNumberLabel(
INITIAL_INVOICE_DATA.language,
template,
),
value: getInvoiceDefaultNumberValue(),
},
} satisfies InvoiceData;
}