Skip to content

Free & Open-Source Invoice Generator - No Sign-Up, No Ads, Instant PDF Export, 100% In-Browser, and Fully Customizable Templates.

feat: add md pages, improve videos json-ld, fix star count formatting (#252)

Vlad Sazonau3b099e95cbcd
diff --git a/e2e/how-it-works.test.ts b/e2e/how-it-works.test.ts
index 6210844..f8900fb 100644
--- a/e2e/how-it-works.test.ts
+++ b/e2e/how-it-works.test.ts
@@ -35,7 +35,7 @@ test.describe("How it works page", () => {
await expect(
page.getByText(
- "Discover how to create, customize, and send professional PDF invoices online with EasyInvoicePDF. Watch step-by-step tutorial videos to learn invoice creation, branding, and customization tips. Start generating invoices instantly in our free online invoice generator.",
+ "Learn how to create, customize, download, and share professional PDF invoices online with EasyInvoicePDF. These step-by-step videos show you how to use our free invoice generator, save seller and buyer details, add branding, and prepare weekly invoices. Whether you need an invoice maker for a one-off bill or a small business invoice template you can reuse, you can start in seconds.",
),
).toBeVisible();
diff --git a/public/de/about.md b/public/de/about.md
new file mode 100644
index 0000000..f3c8397
--- /dev/null
+++ b/public/de/about.md
@@ -0,0 +1,52 @@
+# Über EasyInvoicePDF
+
+> Sprache: Deutsch
+> Kanonische Seite: https://easyinvoicepdf.com/de/about
+> Produkt: https://easyinvoicepdf.com/
+> Zuletzt aktualisiert: 2026-08-02
+
+EasyInvoicePDF ist ein kostenloser Open-Source-Rechnungsgenerator zum Erstellen, Anpassen, Anzeigen, Teilen und Herunterladen professioneller PDF-Rechnungen. Die Anwendung läuft im Browser, benötigt weder Konto noch Anmeldung und eignet sich für Freiberufler, Berater, Agenturen und kleine Unternehmen.
+
+## Wichtigste Fakten
+
+- Kostenlose Rechnungserstellung, Live-Vorschau und PDF-Download.
+- Kein Konto, keine Anmeldung, kein Abonnement und keine Werbung.
+- Rechnungsvorschau und PDF-Erstellung erfolgen im Browser des Benutzers.
+- Verkäufer- und Kundendaten, Positionen, Währung, Datum, Steuerbezeichnungen, Sprache und Layout sind anpassbar.
+- Unterstützt 10 Sprachen und mehr als 120 Währungen.
+- Unterstützt Mehrwertsteuer, GST, Sales Tax und eigene Steuerbezeichnungen.
+- Enthält eine klassische und eine von Stripe inspirierte Vorlage, eigene Logos, QR-Codes und mehrseitige PDFs.
+- Teilbare Links enthalten eine komprimierte Kopie der Rechnungsdaten in der URL. Jede Person mit dem vollständigen Link kann ihn öffnen.
+- Der Quellcode steht unter der GNU-AGPL-3.0-Lizenz und kann selbst gehostet werden.
+
+## Wofür EasyInvoicePDF gedacht ist
+
+EasyInvoicePDF eignet sich, wenn schnell eine professionelle PDF-Rechnung benötigt wird, ohne Buchhaltungssoftware zu installieren oder ein Konto anzulegen. Es unterstützt Einzelrechnungen, wiederverwendbare Firmen- und Kundendaten, internationale Währungen, lokalisierte Bezeichnungen und Rechnungen mit eigenem Branding.
+
+EasyInvoicePDF ist ein Dokumentengenerator, keine Buchhaltungssoftware, Steuerberatung, Zahlungsabwicklung oder Garantie für rechtliche beziehungsweise steuerliche Konformität. Benutzer müssen lokale Rechnungsanforderungen selbst prüfen.
+
+## Häufige Fragen
+
+### Ist EasyInvoicePDF kostenlos?
+
+Ja. Die grundlegende Rechnungserstellung, Live-Vorschau und der PDF-Download sind kostenlos.
+
+### Ist ein Konto erforderlich?
+
+Nein. Rechnungen können ohne Registrierung oder Anmeldung erstellt und heruntergeladen werden.
+
+### Wo werden Rechnungsdaten verarbeitet?
+
+Normale Bearbeitung, Vorschau und PDF-Erstellung finden im Browser statt. EasyInvoicePDF speichert Rechnungsinhalte dabei nicht auf seinen Servern. Geteilte URLs enthalten Rechnungsdaten und sollten nur an vertrauenswürdige Empfänger gesendet werden.
+
+### Kann ich die Rechnung anpassen?
+
+Ja. Firmendaten, Positionen, Preise, Währung, Datum, Steuern, Sprache, Logo, QR-Code und Layout können geändert werden.
+
+## Offizielle Links
+
+- [Rechnungsgenerator öffnen](https://easyinvoicepdf.com/?template=default)
+- [Anleitungen ansehen](https://easyinvoicepdf.com/how-it-works)
+- [Quellcode ansehen](https://github.com/VladSez/easy-invoice-pdf)
+- [Nutzungsbedingungen](https://easyinvoicepdf.com/tos)
+- [Maschinenlesbare Produktübersicht](https://easyinvoicepdf.com/llms.txt)
diff --git a/public/en/about.md b/public/en/about.md
new file mode 100644
index 0000000..3e72f55
--- /dev/null
+++ b/public/en/about.md
@@ -0,0 +1,52 @@
+# About EasyInvoicePDF
+
+> Language: English
+> Canonical page: https://easyinvoicepdf.com/en/about
+> Product: https://easyinvoicepdf.com/
+> Last updated: 2026-08-02
+
+EasyInvoicePDF is a free, open-source online invoice generator for creating, customizing, previewing, sharing, and downloading professional PDF invoices. It runs in the browser, requires no account or sign-up, and is designed for freelancers, consultants, agencies, and small businesses.
+
+## Key facts
+
+- Free core invoice creation, live preview, and PDF download.
+- No account, login, subscription, or advertising.
+- Invoice preview and PDF generation run in the user's browser.
+- Seller and buyer details, line items, currency, dates, tax labels, tax amounts, language, and layout are customizable.
+- Supports 10 interface and invoice languages: English, Polish, German, Spanish, Portuguese, Russian, Ukrainian, French, Italian, and Dutch.
+- Supports 120+ currencies, flexible VAT, GST, sales-tax, and custom tax labels.
+- Includes default and Stripe-inspired invoice templates, custom logos, QR codes, and multi-page PDFs.
+- Shareable links encode a compressed copy of invoice data in the URL. Anyone with the complete link can open it.
+- Source code is available under the GNU AGPL-3.0 license and can be self-hosted.
+
+## What EasyInvoicePDF is for
+
+Use EasyInvoicePDF when you need a professional PDF invoice quickly without installing billing software or creating an account. It is useful for one-off invoices, recurring seller and buyer details, international currencies, localized invoice labels, branded documents, and weekly service invoicing.
+
+EasyInvoicePDF is an invoice document generator, not accounting software, tax advice, a payment processor, or a guarantee of legal or tax compliance. Users are responsible for checking local invoice requirements.
+
+## Common questions
+
+### Is EasyInvoicePDF free?
+
+Yes. Core invoicing, live preview, and PDF download are free. There is no paid subscription required for these functions.
+
+### Is an account required?
+
+No. Open the editor, enter the invoice details, preview the document, and download the PDF without registering or logging in.
+
+### Where is invoice data processed?
+
+Normal editing, preview, and PDF generation happen in the browser. EasyInvoicePDF does not store invoice content on its servers during the normal edit-and-download workflow. Shared URLs contain invoice data, so they should only be sent to trusted recipients.
+
+### Can the invoice be customized?
+
+Yes. Users can edit seller and buyer information, items, prices, currencies, dates, tax labels and values, language, logo, QR code, and layout.
+
+## Authoritative links
+
+- [Open the invoice generator](https://easyinvoicepdf.com/?template=default)
+- [Watch the tutorials](https://easyinvoicepdf.com/how-it-works)
+- [Read the source code](https://github.com/VladSez/easy-invoice-pdf)
+- [Read the Terms of Service](https://easyinvoicepdf.com/tos)
+- [Machine-readable product overview](https://easyinvoicepdf.com/llms.txt)
diff --git a/public/es/about.md b/public/es/about.md
new file mode 100644
index 0000000..9562d74
--- /dev/null
+++ b/public/es/about.md
@@ -0,0 +1,52 @@
+# Acerca de EasyInvoicePDF
+
+> Idioma: español
+> Página canónica: https://easyinvoicepdf.com/es/about
+> Producto: https://easyinvoicepdf.com/
+> Última actualización: 2026-08-02
+
+EasyInvoicePDF es un generador de facturas PDF gratuito y de código abierto para crear, personalizar, previsualizar, compartir y descargar facturas profesionales. Funciona en el navegador, no requiere cuenta ni registro y está pensado para autónomos, consultores, agencias y pequeñas empresas.
+
+## Datos clave
+
+- Creación de facturas, vista previa en vivo y descarga de PDF gratuitas.
+- Sin cuenta, inicio de sesión, suscripción ni publicidad.
+- La vista previa y la generación del PDF se realizan en el navegador del usuario.
+- Permite personalizar vendedor, cliente, artículos, moneda, fechas, impuestos, idioma y diseño.
+- Compatible con 10 idiomas y más de 120 monedas.
+- Admite IVA, GST, impuesto sobre ventas y etiquetas fiscales personalizadas.
+- Incluye una plantilla clásica y otra inspirada en Stripe, logotipo personalizado, códigos QR y PDF de varias páginas.
+- Los enlaces compartidos guardan una copia comprimida de los datos de la factura en la URL. Cualquier persona con el enlace completo puede abrirlo.
+- El código fuente usa la licencia GNU AGPL-3.0 y se puede alojar en un servidor propio.
+
+## Para qué sirve EasyInvoicePDF
+
+Use EasyInvoicePDF cuando necesite una factura PDF profesional rápidamente, sin instalar software de contabilidad ni crear una cuenta. Es útil para facturas puntuales, datos reutilizables de empresas y clientes, monedas internacionales, etiquetas localizadas y documentos con su propia marca.
+
+EasyInvoicePDF genera documentos de factura; no es software contable, asesoramiento fiscal, un procesador de pagos ni una garantía de cumplimiento legal o tributario. Cada usuario debe comprobar los requisitos locales.
+
+## Preguntas frecuentes
+
+### ¿EasyInvoicePDF es gratis?
+
+Sí. La creación básica de facturas, la vista previa y la descarga del PDF son gratuitas.
+
+### ¿Necesito una cuenta?
+
+No. Puede crear y descargar una factura sin registrarse ni iniciar sesión.
+
+### ¿Dónde se procesan los datos?
+
+La edición normal, la vista previa y la creación del PDF ocurren en el navegador. EasyInvoicePDF no almacena el contenido de la factura en sus servidores durante este flujo. Las URL compartidas contienen datos de la factura y solo deben enviarse a destinatarios de confianza.
+
+### ¿Puedo personalizar la factura?
+
+Sí. Puede editar los datos del vendedor y del cliente, así como artículos, precios, moneda, fechas, impuestos, idioma, logotipo, código QR y diseño.
+
+## Enlaces oficiales
+
+- [Abrir el generador de facturas](https://easyinvoicepdf.com/?template=default)
+- [Ver los tutoriales](https://easyinvoicepdf.com/how-it-works)
+- [Consultar el código fuente](https://github.com/VladSez/easy-invoice-pdf)
+- [Condiciones del servicio](https://easyinvoicepdf.com/tos)
+- [Resumen para agentes](https://easyinvoicepdf.com/llms.txt)
diff --git a/public/fr/about.md b/public/fr/about.md
new file mode 100644
index 0000000..2bd407f
--- /dev/null
+++ b/public/fr/about.md
@@ -0,0 +1,52 @@
+# À propos d’EasyInvoicePDF
+
+> Langue : français
+> Page canonique : https://easyinvoicepdf.com/fr/about
+> Produit : https://easyinvoicepdf.com/
+> Dernière mise à jour : 2026-08-02
+
+EasyInvoicePDF est un générateur de factures PDF gratuit et open source qui permet de créer, personnaliser, prévisualiser, partager et télécharger des factures professionnelles. Il fonctionne dans le navigateur, ne nécessite ni compte ni inscription et s’adresse aux indépendants, consultants, agences et petites entreprises.
+
+## Informations essentielles
+
+- Création de factures, aperçu en direct et téléchargement PDF gratuits.
+- Aucun compte, aucune connexion, aucun abonnement et aucune publicité.
+- L’aperçu et la génération du PDF s’effectuent dans le navigateur de l’utilisateur.
+- Les coordonnées du vendeur et du client, les articles, la devise, les dates, les taxes, la langue et la mise en page sont personnalisables.
+- Prend en charge 10 langues et plus de 120 devises.
+- Prend en charge la TVA, la GST, la taxe de vente et les libellés fiscaux personnalisés.
+- Inclut des modèles classique et inspiré de Stripe, un logo personnalisé, des codes QR et des PDF multipages.
+- Les liens partageables contiennent une copie compressée des données de la facture dans l’URL. Toute personne disposant du lien complet peut l’ouvrir.
+- Le code source est proposé sous licence GNU AGPL-3.0 et peut être auto-hébergé.
+
+## À quoi sert EasyInvoicePDF
+
+Utilisez EasyInvoicePDF pour produire rapidement une facture PDF professionnelle sans installer de logiciel comptable ni créer de compte. Il convient aux factures ponctuelles, aux coordonnées réutilisables, aux devises internationales, aux libellés localisés et aux documents personnalisés avec votre marque.
+
+EasyInvoicePDF est un générateur de documents, pas un logiciel de comptabilité, un conseil fiscal, un service de paiement ni une garantie de conformité juridique ou fiscale. L’utilisateur doit vérifier les exigences locales.
+
+## Questions fréquentes
+
+### EasyInvoicePDF est-il gratuit ?
+
+Oui. La création de factures, l’aperçu en direct et le téléchargement du PDF sont gratuits.
+
+### Un compte est-il nécessaire ?
+
+Non. Vous pouvez créer et télécharger une facture sans inscription ni connexion.
+
+### Où les données sont-elles traitées ?
+
+L’édition normale, l’aperçu et la génération du PDF ont lieu dans le navigateur. EasyInvoicePDF ne stocke pas le contenu de la facture sur ses serveurs pendant ce processus. Les URL partagées contiennent des données de facture et ne doivent être envoyées qu’à des destinataires de confiance.
+
+### Puis-je personnaliser la facture ?
+
+Oui. Vous pouvez modifier les entreprises, les articles, les prix, la devise, les dates, les taxes, la langue, le logo, le code QR et la mise en page.
+
+## Liens officiels
+
+- [Ouvrir le générateur de factures](https://easyinvoicepdf.com/?template=default)
+- [Voir les tutoriels](https://easyinvoicepdf.com/how-it-works)
+- [Consulter le code source](https://github.com/VladSez/easy-invoice-pdf)
+- [Conditions d’utilisation](https://easyinvoicepdf.com/tos)
+- [Présentation pour les agents](https://easyinvoicepdf.com/llms.txt)
diff --git a/public/how-it-works.md b/public/how-it-works.md
new file mode 100644
index 0000000..1b4f20d
--- /dev/null
+++ b/public/how-it-works.md
@@ -0,0 +1,61 @@
+# How EasyInvoicePDF works
+
+> Canonical page: https://easyinvoicepdf.com/how-it-works
+> Invoice editor: https://easyinvoicepdf.com/
+> Language: English
+> Last updated: 2026-08-02
+
+EasyInvoicePDF lets users create a professional PDF invoice in the browser: enter seller and buyer information, add invoice items and tax settings, customize the document, review the live preview, and download the PDF. No account or sign-up is required.
+
+## Basic workflow
+
+1. Open the invoice editor.
+2. Add or select seller details.
+3. Add or select buyer details.
+4. Enter the invoice number, dates, currency, language, and line items.
+5. Configure discounts, VAT, GST, sales tax, or custom tax labels if required.
+6. Choose a template and optionally add a logo or QR code.
+7. Check the live PDF preview and totals.
+8. Download the PDF or create a shareable link for a trusted recipient.
+
+## Video tutorials
+
+### EasyInvoicePDF overview
+
+Explains how to create and customize a professional PDF invoice.
+
+- [Watch on the tutorial page](https://easyinvoicepdf.com/how-it-works?video=overview)
+- [Watch on YouTube](https://www.youtube.com/watch?v=iAROeCIcZ40)
+
+### Add a seller
+
+Shows how to save seller information and reuse it on future invoices.
+
+- [Watch on the tutorial page](https://easyinvoicepdf.com/how-it-works?video=add-seller)
+- [Watch on YouTube](https://www.youtube.com/watch?v=xfSF35c0vfU)
+
+### Add a buyer
+
+Shows how to save buyer information and reuse it on future invoices.
+
+- [Watch on the tutorial page](https://easyinvoicepdf.com/how-it-works?video=add-buyer)
+- [Watch on YouTube](https://www.youtube.com/watch?v=XxAY0YGgXIk)
+
+### Create invoices for one week
+
+Shows how to generate invoices for a week of work.
+
+- [Watch on the tutorial page](https://easyinvoicepdf.com/how-it-works?video=weekly-invoices)
+- [Watch on YouTube](https://www.youtube.com/watch?v=6KzDBBiAJmg)
+
+## Data handling
+
+Normal editing, preview, and PDF generation run in the browser. EasyInvoicePDF does not store invoice content on its servers during the normal edit-and-download workflow. A shareable invoice URL contains a compressed copy of the invoice data and should be treated as sensitive.
+
+## Related authoritative resources
+
+- [Open the free invoice generator](https://easyinvoicepdf.com/?template=default)
+- [About EasyInvoicePDF](https://easyinvoicepdf.com/en/about)
+- [GitHub source code](https://github.com/VladSez/easy-invoice-pdf)
+- [Terms of Service](https://easyinvoicepdf.com/tos)
+- [Machine-readable site overview](https://easyinvoicepdf.com/llms.txt)
diff --git a/public/invoice-generator.md b/public/invoice-generator.md
new file mode 100644
index 0000000..b574dc3
--- /dev/null
+++ b/public/invoice-generator.md
@@ -0,0 +1,63 @@
+# EasyInvoicePDF free invoice generator
+
+> Canonical page: https://easyinvoicepdf.com/
+> Direct editor: https://easyinvoicepdf.com/
+> Language: English
+> Last updated: 2026-08-02
+
+EasyInvoicePDF is a free, open-source invoice generator that creates professional PDF invoices directly in a web browser. It requires no account, login, subscription, or software installation. Users can edit an invoice with a live PDF preview and download the finished document immediately.
+
+## Best for
+
+- Freelancers and consultants creating one-off or recurring client invoices.
+- Small businesses that need reusable seller and buyer details.
+- Agencies producing branded invoices with a custom logo.
+- International work requiring localized labels and multiple currencies.
+- Privacy-conscious users who prefer browser-side document generation.
+- Developers who want an open-source invoice generator they can inspect or self-host.
+
+## How to create a PDF invoice
+
+1. [Open the invoice editor](https://easyinvoicepdf.com/?template=default).
+2. Enter the seller and buyer names, addresses, tax numbers, and optional contact details.
+3. Set the invoice number, issue date, due date, currency, and language.
+4. Add line items with descriptions, quantities, units, prices, discounts, and taxes as needed.
+5. Choose the default or Stripe-inspired layout and optionally add a logo or QR code.
+6. Review the live PDF preview, totals, labels, and page breaks.
+7. Download the finished PDF or create a shareable invoice link.
+
+## Product capabilities
+
+- Real-time PDF preview while invoice fields are edited.
+- Instant PDF download and automatic multi-page layout.
+- Default and Stripe-inspired invoice templates.
+- Custom logo and QR-code support.
+- Reusable seller and buyer details.
+- More than 120 currencies.
+- Invoice labels and formatting in English, Polish, German, Spanish, Portuguese, Russian, Ukrainian, French, Italian, and Dutch.
+- Flexible VAT, GST, sales-tax, and custom tax labels.
+- Shareable URLs with invoice state encoded in the link.
+- Open-source code under the GNU AGPL-3.0 license.
+
+## Privacy and data handling
+
+Normal invoice editing, preview, and PDF generation happen in the user's browser. EasyInvoicePDF does not store invoice content on its servers during the normal edit-and-download workflow. A shareable URL contains a compressed copy of invoice data; anyone with the full URL can open it, so links should only be sent to trusted recipients.
+
+## Cost and account requirements
+
+Core invoice creation, live preview, and PDF download are free. No account or sign-up is required, and the product does not display ads.
+
+## Important limitations
+
+EasyInvoicePDF creates invoice documents. It is not accounting software, bookkeeping advice, tax advice, a payment processor, or a guarantee that an invoice satisfies the laws of a particular jurisdiction. Users must verify local tax, numbering, retention, and invoice-field requirements.
+
+## Related authoritative resources
+
+- [About EasyInvoicePDF](https://easyinvoicepdf.com/en/about)
+- [Step-by-step video tutorials](https://easyinvoicepdf.com/how-it-works)
+- [Free invoice generator with no login](https://easyinvoicepdf.com/invoice-generator-no-login)
+- [Free PDF invoice templates](https://easyinvoicepdf.com/invoice-template-pdf)
+- [Open-source invoice generator](https://easyinvoicepdf.com/open-source-invoice-generator)
+- [GitHub source code](https://github.com/VladSez/easy-invoice-pdf)
+- [Terms of Service](https://easyinvoicepdf.com/tos)
+- [Machine-readable site overview](https://easyinvoicepdf.com/llms.txt)
diff --git a/public/it/about.md b/public/it/about.md
new file mode 100644
index 0000000..62a82b3
--- /dev/null
+++ b/public/it/about.md
@@ -0,0 +1,52 @@
+# Informazioni su EasyInvoicePDF
+
+> Lingua: italiano
+> Pagina canonica: https://easyinvoicepdf.com/it/about
+> Prodotto: https://easyinvoicepdf.com/
+> Ultimo aggiornamento: 2026-08-02
+
+EasyInvoicePDF è un generatore di fatture PDF gratuito e open source per creare, personalizzare, visualizzare in anteprima, condividere e scaricare fatture professionali. Funziona nel browser, non richiede account o registrazione ed è pensato per freelance, consulenti, agenzie e piccole imprese.
+
+## Informazioni principali
+
+- Creazione di fatture, anteprima in tempo reale e download PDF gratuiti.
+- Nessun account, accesso, abbonamento o pubblicità.
+- L’anteprima e la generazione del PDF avvengono nel browser dell’utente.
+- Dati del venditore e del cliente, voci, valuta, date, imposte, lingua e layout sono personalizzabili.
+- Supporta 10 lingue e oltre 120 valute.
+- Supporta IVA, GST, imposta sulle vendite ed etichette fiscali personalizzate.
+- Include modelli classico e ispirato a Stripe, logo personalizzato, codici QR e PDF multipagina.
+- I link condivisibili contengono una copia compressa dei dati della fattura nell’URL. Chiunque abbia il link completo può aprirlo.
+- Il codice sorgente è disponibile con licenza GNU AGPL-3.0 e può essere ospitato autonomamente.
+
+## A cosa serve EasyInvoicePDF
+
+Usa EasyInvoicePDF quando devi creare rapidamente una fattura PDF professionale senza installare software di contabilità o creare un account. È utile per fatture occasionali, dati riutilizzabili delle aziende e dei clienti, valute internazionali, etichette localizzate e documenti con il proprio marchio.
+
+EasyInvoicePDF è un generatore di documenti, non un software di contabilità, una consulenza fiscale, un elaboratore di pagamenti o una garanzia di conformità legale o tributaria. L’utente deve verificare i requisiti locali.
+
+## Domande frequenti
+
+### EasyInvoicePDF è gratuito?
+
+Sì. La creazione di fatture, l’anteprima e il download del PDF sono gratuiti.
+
+### È necessario un account?
+
+No. Puoi creare e scaricare una fattura senza registrarti o accedere.
+
+### Dove vengono elaborati i dati?
+
+La normale modifica, l’anteprima e la generazione del PDF avvengono nel browser. EasyInvoicePDF non memorizza il contenuto della fattura sui propri server durante questo processo. Gli URL condivisi contengono dati della fattura e devono essere inviati solo a destinatari fidati.
+
+### Posso personalizzare la fattura?
+
+Sì. Puoi modificare aziende, voci, prezzi, valuta, date, imposte, lingua, logo, codice QR e layout.
+
+## Link ufficiali
+
+- [Apri il generatore di fatture](https://easyinvoicepdf.com/?template=default)
+- [Guarda i tutorial](https://easyinvoicepdf.com/how-it-works)
+- [Consulta il codice sorgente](https://github.com/VladSez/easy-invoice-pdf)
+- [Termini di servizio](https://easyinvoicepdf.com/tos)
+- [Panoramica per gli agenti](https://easyinvoicepdf.com/llms.txt)
diff --git a/public/llms.txt b/public/llms.txt
index c940908..34fea92 100644
--- a/public/llms.txt
+++ b/public/llms.txt
@@ -64,6 +64,22 @@ Free, open-source invoice generator for creating professional PDF invoices in th
- Mobile-friendly design: responsive layout and touch-optimized UX for phones and tablets.
- Open-source codebase with a clear AGPL-3.0
+## Machine-readable Markdown pages
+
+Concise, citation-friendly Markdown versions of key product pages for search engines, AI assistants, and retrieval agents.
+
+- [Invoice Generator](https://easyinvoicepdf.com/invoice-generator.md)
+- [How EasyInvoicePDF Works](https://easyinvoicepdf.com/how-it-works.md)
+- [About EasyInvoicePDF — English](https://easyinvoicepdf.com/en/about.md)
+- [O EasyInvoicePDF — Polish](https://easyinvoicepdf.com/pl/about.md)
+- [Über EasyInvoicePDF — German](https://easyinvoicepdf.com/de/about.md)
+- [Acerca de EasyInvoicePDF — Spanish](https://easyinvoicepdf.com/es/about.md)
+- [Sobre o EasyInvoicePDF — Portuguese](https://easyinvoicepdf.com/pt/about.md)
+- [О EasyInvoicePDF — Russian](https://easyinvoicepdf.com/ru/about.md)
+- [Про EasyInvoicePDF — Ukrainian](https://easyinvoicepdf.com/uk/about.md)
+- [À propos d’EasyInvoicePDF — French](https://easyinvoicepdf.com/fr/about.md)
+- [Informazioni su EasyInvoicePDF — Italian](https://easyinvoicepdf.com/it/about.md)
+- [Over EasyInvoicePDF — Dutch](https://easyinvoicepdf.com/nl/about.md)
## Solution pages
diff --git a/public/nl/about.md b/public/nl/about.md
new file mode 100644
index 0000000..2022058
--- /dev/null
+++ b/public/nl/about.md
@@ -0,0 +1,52 @@
+# Over EasyInvoicePDF
+
+> Taal: Nederlands
+> Canonieke pagina: https://easyinvoicepdf.com/nl/about
+> Product: https://easyinvoicepdf.com/
+> Laatst bijgewerkt: 2026-08-02
+
+EasyInvoicePDF is een gratis, open-source PDF-factuurgenerator voor het maken, aanpassen, bekijken, delen en downloaden van professionele facturen. De toepassing werkt in de browser, vereist geen account of registratie en is bedoeld voor freelancers, consultants, bureaus en kleine bedrijven.
+
+## Belangrijkste feiten
+
+- Gratis facturen maken, live voorbeeld bekijken en PDF downloaden.
+- Geen account, login, abonnement of advertenties.
+- Het factuurvoorbeeld en de PDF-generatie vinden plaats in de browser van de gebruiker.
+- Gegevens van verkoper en klant, regels, valuta, datums, belastingen, taal en lay-out zijn aanpasbaar.
+- Ondersteunt 10 talen en meer dan 120 valuta’s.
+- Ondersteunt btw, GST, omzetbelasting en aangepaste belastinglabels.
+- Bevat een klassiek en een op Stripe geïnspireerd sjabloon, eigen logo, QR-codes en PDF’s met meerdere pagina’s.
+- Deelbare links bevatten een gecomprimeerde kopie van de factuurgegevens in de URL. Iedereen met de volledige link kan deze openen.
+- De broncode is beschikbaar onder de GNU AGPL-3.0-licentie en kan zelf worden gehost.
+
+## Waarvoor EasyInvoicePDF bedoeld is
+
+Gebruik EasyInvoicePDF wanneer je snel een professionele PDF-factuur nodig hebt zonder boekhoudsoftware te installeren of een account aan te maken. Het is geschikt voor eenmalige facturen, herbruikbare bedrijfs- en klantgegevens, internationale valuta’s, vertaalde labels en documenten met een eigen huisstijl.
+
+EasyInvoicePDF is een documentgenerator, geen boekhoudsoftware, belastingadvies, betalingsverwerker of garantie op juridische of fiscale naleving. Gebruikers moeten lokale factuurvereisten zelf controleren.
+
+## Veelgestelde vragen
+
+### Is EasyInvoicePDF gratis?
+
+Ja. Facturen maken, live voorbeeld bekijken en PDF downloaden zijn gratis.
+
+### Is een account nodig?
+
+Nee. Je kunt zonder registratie of login een factuur maken en downloaden.
+
+### Waar worden factuurgegevens verwerkt?
+
+Normale bewerking, voorbeeldweergave en PDF-generatie gebeuren in de browser. EasyInvoicePDF slaat de factuurinhoud tijdens dit proces niet op zijn servers op. Gedeelde URL’s bevatten factuurgegevens en mogen alleen naar vertrouwde ontvangers worden gestuurd.
+
+### Kan ik de factuur aanpassen?
+
+Ja. Je kunt bedrijven, regels, prijzen, valuta, datums, belastingen, taal, logo, QR-code en lay-out wijzigen.
+
+## Officiële links
+
+- [Open de factuurgenerator](https://easyinvoicepdf.com/?template=default)
+- [Bekijk de handleidingen](https://easyinvoicepdf.com/how-it-works)
+- [Bekijk de broncode](https://github.com/VladSez/easy-invoice-pdf)
+- [Servicevoorwaarden](https://easyinvoicepdf.com/tos)
+- [Productoverzicht voor agents](https://easyinvoicepdf.com/llms.txt)
diff --git a/public/pl/about.md b/public/pl/about.md
new file mode 100644
index 0000000..ad3a2d8
--- /dev/null
+++ b/public/pl/about.md
@@ -0,0 +1,52 @@
+# O EasyInvoicePDF
+
+> Język: polski
+> Strona kanoniczna: https://easyinvoicepdf.com/pl/about
+> Produkt: https://easyinvoicepdf.com/
+> Ostatnia aktualizacja: 2026-08-02
+
+EasyInvoicePDF to darmowy generator faktur PDF o otwartym kodzie źródłowym. Pozwala tworzyć, dostosowywać, przeglądać, udostępniać i pobierać profesjonalne faktury bezpośrednio w przeglądarce. Nie wymaga konta ani rejestracji i jest przeznaczony dla freelancerów, konsultantów, agencji oraz małych firm.
+
+## Najważniejsze informacje
+
+- Bezpłatne tworzenie faktur, podgląd na żywo i pobieranie PDF.
+- Bez konta, logowania, abonamentu i reklam.
+- Podgląd faktury i generowanie PDF odbywają się w przeglądarce użytkownika.
+- Można dostosować dane sprzedawcy i nabywcy, pozycje, walutę, daty, podatki, język i układ.
+- Obsługuje 10 języków oraz ponad 120 walut.
+- Obsługuje VAT, GST, podatek od sprzedaży i własne etykiety podatkowe.
+- Zawiera szablon klasyczny i inspirowany Stripe, własne logo, kody QR oraz wielostronicowe PDF-y.
+- Link do udostępniania zawiera skompresowane dane faktury w adresie URL. Każda osoba z pełnym linkiem może go otworzyć.
+- Kod źródłowy jest dostępny na licencji GNU AGPL-3.0 i można go hostować samodzielnie.
+
+## Do czego służy EasyInvoicePDF
+
+EasyInvoicePDF sprawdza się, gdy trzeba szybko utworzyć profesjonalną fakturę PDF bez instalowania programu księgowego i bez zakładania konta. Ułatwia wystawianie pojedynczych faktur, ponowne użycie danych firm, pracę z walutami międzynarodowymi, lokalizację etykiet i tworzenie dokumentów z własnym logo.
+
+EasyInvoicePDF jest generatorem dokumentów, a nie programem księgowym, poradą podatkową, operatorem płatności ani gwarancją zgodności prawnej. Użytkownik powinien sprawdzić lokalne wymagania dotyczące faktur.
+
+## Częste pytania
+
+### Czy EasyInvoicePDF jest darmowy?
+
+Tak. Podstawowe tworzenie faktur, podgląd na żywo i pobieranie PDF są bezpłatne.
+
+### Czy potrzebuję konta?
+
+Nie. Fakturę można utworzyć i pobrać bez rejestracji i logowania.
+
+### Gdzie przetwarzane są dane faktury?
+
+Standardowa edycja, podgląd i generowanie PDF odbywają się w przeglądarce. EasyInvoicePDF nie zapisuje treści faktury na swoich serwerach w zwykłym procesie edycji i pobierania. Udostępniany adres URL zawiera dane faktury, dlatego należy wysyłać go wyłącznie zaufanym odbiorcom.
+
+### Czy mogę dostosować fakturę?
+
+Tak. Można zmienić dane firm, pozycje, ceny, walutę, daty, podatki, język, logo, kod QR i układ.
+
+## Oficjalne linki
+
+- [Otwórz generator faktur](https://easyinvoicepdf.com/?template=default)
+- [Obejrzyj instrukcje](https://easyinvoicepdf.com/how-it-works)
+- [Kod źródłowy](https://github.com/VladSez/easy-invoice-pdf)
+- [Warunki korzystania](https://easyinvoicepdf.com/tos)
+- [Opis produktu dla agentów](https://easyinvoicepdf.com/llms.txt)
diff --git a/public/pt/about.md b/public/pt/about.md
new file mode 100644
index 0000000..e29f60a
--- /dev/null
+++ b/public/pt/about.md
@@ -0,0 +1,52 @@
+# Sobre o EasyInvoicePDF
+
+> Idioma: português
+> Página canónica: https://easyinvoicepdf.com/pt/about
+> Produto: https://easyinvoicepdf.com/
+> Última atualização: 2026-08-02
+
+EasyInvoicePDF é um gerador gratuito e de código aberto para criar, personalizar, pré-visualizar, partilhar e descarregar faturas profissionais em PDF. Funciona no navegador, não exige conta nem registo e foi criado para freelancers, consultores, agências e pequenas empresas.
+
+## Factos principais
+
+- Criação de faturas, pré-visualização em tempo real e download de PDF gratuitos.
+- Sem conta, início de sessão, subscrição ou publicidade.
+- A pré-visualização e a geração do PDF ocorrem no navegador do utilizador.
+- Dados do vendedor e comprador, itens, moeda, datas, impostos, idioma e layout são personalizáveis.
+- Compatível com 10 idiomas e mais de 120 moedas.
+- Suporta IVA, GST, imposto sobre vendas e etiquetas fiscais personalizadas.
+- Inclui modelos clássico e inspirado no Stripe, logótipo personalizado, códigos QR e PDFs com várias páginas.
+- Os links partilháveis guardam uma cópia comprimida dos dados da fatura no URL. Qualquer pessoa com o link completo pode abri-lo.
+- O código-fonte está disponível sob a licença GNU AGPL-3.0 e pode ser alojado pelo próprio utilizador.
+
+## Para que serve o EasyInvoicePDF
+
+Use o EasyInvoicePDF quando precisar rapidamente de uma fatura PDF profissional, sem instalar software de contabilidade nem criar uma conta. É útil para faturas pontuais, dados reutilizáveis de empresas e clientes, moedas internacionais, etiquetas localizadas e documentos com a sua marca.
+
+O EasyInvoicePDF é um gerador de documentos; não é um software de contabilidade, um serviço de aconselhamento fiscal, um processador de pagamentos nem uma garantia de conformidade legal ou tributária. O utilizador deve confirmar os requisitos locais.
+
+## Perguntas frequentes
+
+### O EasyInvoicePDF é gratuito?
+
+Sim. A criação básica de faturas, a pré-visualização e o download do PDF são gratuitos.
+
+### Preciso de uma conta?
+
+Não. Pode criar e descarregar uma fatura sem registo nem início de sessão.
+
+### Onde são processados os dados?
+
+A edição normal, a pré-visualização e a geração do PDF acontecem no navegador. O EasyInvoicePDF não armazena o conteúdo da fatura nos seus servidores durante este processo. Os URLs partilhados contêm dados da fatura e só devem ser enviados a destinatários de confiança.
+
+### Posso personalizar a fatura?
+
+Sim. Pode alterar empresas, itens, preços, moeda, datas, impostos, idioma, logótipo, código QR e layout.
+
+## Links oficiais
+
+- [Abrir o gerador de faturas](https://easyinvoicepdf.com/?template=default)
+- [Ver os tutoriais](https://easyinvoicepdf.com/how-it-works)
+- [Consultar o código-fonte](https://github.com/VladSez/easy-invoice-pdf)
+- [Termos de Serviço](https://easyinvoicepdf.com/tos)
+- [Resumo para agentes](https://easyinvoicepdf.com/llms.txt)
diff --git a/public/ru/about.md b/public/ru/about.md
new file mode 100644
index 0000000..e987490
--- /dev/null
+++ b/public/ru/about.md
@@ -0,0 +1,52 @@
+# О EasyInvoicePDF
+
+> Язык: русский
+> Каноническая страница: https://easyinvoicepdf.com/ru/about
+> Продукт: https://easyinvoicepdf.com/
+> Последнее обновление: 2026-08-02
+
+EasyInvoicePDF — бесплатный генератор PDF-счетов с открытым исходным кодом. Он позволяет создавать, настраивать, просматривать, отправлять по ссылке и скачивать профессиональные счета. Приложение работает в браузере, не требует аккаунта или регистрации и подходит фрилансерам, консультантам, агентствам и малому бизнесу.
+
+## Основные факты
+
+- Бесплатное создание счетов, предпросмотр в реальном времени и скачивание PDF.
+- Без аккаунта, входа, подписки и рекламы.
+- Предпросмотр и генерация PDF выполняются в браузере пользователя.
+- Можно настроить данные продавца и покупателя, позиции, валюту, даты, налоги, язык и оформление.
+- Поддерживает 10 языков и более 120 валют.
+- Поддерживает НДС, GST, налог с продаж и пользовательские налоговые обозначения.
+- Есть классический и вдохновлённый Stripe шаблоны, собственный логотип, QR-коды и многостраничные PDF.
+- Ссылка для совместного доступа содержит сжатую копию данных счета в URL. Любой человек с полной ссылкой может её открыть.
+- Исходный код доступен по лицензии GNU AGPL-3.0 и подходит для самостоятельного размещения.
+
+## Для чего нужен EasyInvoicePDF
+
+EasyInvoicePDF подходит, когда нужно быстро создать профессиональный PDF-счет без установки бухгалтерской программы и без регистрации. Сервис удобен для разовых счетов, повторного использования реквизитов компаний и клиентов, международных валют, локализованных подписей и фирменного оформления.
+
+EasyInvoicePDF — генератор документов, а не бухгалтерская программа, налоговая консультация, платёжный сервис или гарантия юридического и налогового соответствия. Пользователь должен самостоятельно проверить местные требования.
+
+## Частые вопросы
+
+### EasyInvoicePDF действительно бесплатен?
+
+Да. Основные функции создания счетов, предпросмотр и скачивание PDF бесплатны.
+
+### Нужен ли аккаунт?
+
+Нет. Счет можно создать и скачать без регистрации и входа.
+
+### Где обрабатываются данные?
+
+Обычное редактирование, предпросмотр и генерация PDF происходят в браузере. EasyInvoicePDF не хранит содержимое счета на своих серверах в этом процессе. Общая URL-ссылка содержит данные счета, поэтому её следует отправлять только доверенным получателям.
+
+### Можно ли настроить счет?
+
+Да. Можно изменить реквизиты, позиции, цены, валюту, даты, налоги, язык, логотип, QR-код и оформление.
+
+## Официальные ссылки
+
+- [Открыть генератор счетов](https://easyinvoicepdf.com/?template=default)
+- [Посмотреть инструкции](https://easyinvoicepdf.com/how-it-works)
+- [Исходный код](https://github.com/VladSez/easy-invoice-pdf)
+- [Условия использования](https://easyinvoicepdf.com/tos)
+- [Описание продукта для агентов](https://easyinvoicepdf.com/llms.txt)
diff --git a/public/uk/about.md b/public/uk/about.md
new file mode 100644
index 0000000..7aef890
--- /dev/null
+++ b/public/uk/about.md
@@ -0,0 +1,52 @@
+# Про EasyInvoicePDF
+
+> Мова: українська
+> Канонічна сторінка: https://easyinvoicepdf.com/uk/about
+> Продукт: https://easyinvoicepdf.com/
+> Останнє оновлення: 2026-08-02
+
+EasyInvoicePDF — безкоштовний генератор PDF-рахунків із відкритим кодом. Він дає змогу створювати, налаштовувати, переглядати, поширювати та завантажувати професійні рахунки. Застосунок працює у браузері, не потребує облікового запису чи реєстрації та підходить фрилансерам, консультантам, агенціям і малому бізнесу.
+
+## Основні факти
+
+- Безкоштовне створення рахунків, попередній перегляд і завантаження PDF.
+- Без облікового запису, входу, підписки та реклами.
+- Попередній перегляд і генерація PDF виконуються у браузері користувача.
+- Можна налаштувати дані продавця й покупця, позиції, валюту, дати, податки, мову та оформлення.
+- Підтримує 10 мов і понад 120 валют.
+- Підтримує ПДВ, GST, податок із продажу та власні податкові позначення.
+- Є класичний і натхненний Stripe шаблони, власний логотип, QR-коди та багатосторінкові PDF.
+- Посилання для поширення містить стиснену копію даних рахунку в URL. Кожен, хто має повне посилання, може його відкрити.
+- Вихідний код доступний за ліцензією GNU AGPL-3.0 і придатний для самостійного розміщення.
+
+## Для чого потрібен EasyInvoicePDF
+
+EasyInvoicePDF корисний, коли треба швидко створити професійний PDF-рахунок без установлення бухгалтерської програми та без реєстрації. Сервіс підходить для разових рахунків, повторного використання реквізитів компаній і клієнтів, міжнародних валют, локалізованих підписів і фірмового оформлення.
+
+EasyInvoicePDF — генератор документів, а не бухгалтерська програма, податкова консультація, платіжний сервіс або гарантія юридичної чи податкової відповідності. Користувач повинен самостійно перевірити місцеві вимоги.
+
+## Часті запитання
+
+### EasyInvoicePDF справді безкоштовний?
+
+Так. Основні функції створення рахунків, попередній перегляд і завантаження PDF безкоштовні.
+
+### Чи потрібен обліковий запис?
+
+Ні. Рахунок можна створити й завантажити без реєстрації та входу.
+
+### Де обробляються дані?
+
+Звичайне редагування, попередній перегляд і генерація PDF відбуваються у браузері. EasyInvoicePDF не зберігає вміст рахунку на своїх серверах під час цього процесу. Спільний URL містить дані рахунку, тому його слід надсилати лише довіреним одержувачам.
+
+### Чи можна налаштувати рахунок?
+
+Так. Можна змінити реквізити, позиції, ціни, валюту, дати, податки, мову, логотип, QR-код і оформлення.
+
+## Офіційні посилання
+
+- [Відкрити генератор рахунків](https://easyinvoicepdf.com/?template=default)
+- [Переглянути інструкції](https://easyinvoicepdf.com/how-it-works)
+- [Вихідний код](https://github.com/VladSez/easy-invoice-pdf)
+- [Умови використання](https://easyinvoicepdf.com/tos)
+- [Опис продукту для агентів](https://easyinvoicepdf.com/llms.txt)
diff --git a/src/app/(app)/page.tsx b/src/app/(app)/page.tsx
index 723feba..c21856f 100644
--- a/src/app/(app)/page.tsx
+++ b/src/app/(app)/page.tsx
@@ -66,6 +66,9 @@ function buildTemplateMetadata(
description: APP_PAGE_DESCRIPTION,
alternates: {
canonical,
+ types: {
+ "text/markdown": `${APP_URL}/invoice-generator.md`,
+ },
},
openGraph: {
title,
diff --git a/src/app/[locale]/about/components/github-star-cta-body.tsx b/src/app/[locale]/about/components/github-star-cta-body.tsx
index 8c314b6..5d20cd9 100644
--- a/src/app/[locale]/about/components/github-star-cta-body.tsx
+++ b/src/app/[locale]/about/components/github-star-cta-body.tsx
@@ -1,5 +1,6 @@
import { fetchGithubStars } from "@/actions/fetch-github-stars";
import { GITHUB_URL } from "@/config";
+import { githubStarCountFormatter } from "@/utils/number-formatter";
/**
* Server component that renders a GitHub star CTA button for the marketing/about page.
@@ -10,13 +11,17 @@ import { GITHUB_URL } from "@/config";
export async function GithubStarCtaMarketingPageBody() {
const githubStarsCount = await fetchGithubStars();
+ const gitHubStarCountFormatted = githubStarCountFormatter
+ .format(githubStarsCount)
+ .toLowerCase();
+
return (
<div className="">
<a
href={GITHUB_URL}
target="_blank"
rel="noopener noreferrer"
- className="group relative inline-flex h-12 items-center justify-center gap-2 overflow-hidden rounded-full border border-slate-800 bg-slate-900 px-6 font-medium text-white transition-all duration-300 hover:border-slate-700 hover:bg-slate-800 active:scale-95"
+ className="group relative inline-flex h-12 items-center justify-center gap-1 overflow-hidden rounded-full border border-slate-800 bg-slate-900 px-6 font-medium text-white transition-all duration-300 hover:border-slate-700 hover:bg-slate-800 active:scale-95"
aria-label="Star project on GitHub"
data-testid="github-star-cta-about-page-button"
>
@@ -40,7 +45,9 @@ export async function GithubStarCtaMarketingPageBody() {
</div>
<div className="mx-2 h-4 w-[1px] bg-slate-300" />
<div className="flex items-center gap-1 text-slate-50 transition-colors group-hover:text-white">
- <span className="font-medium tabular-nums">{githubStarsCount}</span>
+ <span className="font-medium tabular-nums">
+ {gitHubStarCountFormatted}
+ </span>
</div>
</a>
</div>
diff --git a/src/app/[locale]/about/layout.tsx b/src/app/[locale]/about/layout.tsx
index 22e44df..5979f8a 100644
--- a/src/app/[locale]/about/layout.tsx
+++ b/src/app/[locale]/about/layout.tsx
@@ -27,6 +27,9 @@ export async function generateMetadata({
keywords: messages.Metadata.about.keywords,
alternates: {
canonical: `${APP_URL}/${params.locale}/about`,
+ types: {
+ "text/markdown": `${APP_URL}/${params.locale}/about.md`,
+ },
languages: {
// @ts-expect-error - x-default is not a valid locale
"x-default": `${APP_URL}/en/about`,
diff --git a/src/app/how-it-works/build-how-it-works-json-ld.test.ts b/src/app/how-it-works/build-how-it-works-json-ld.test.ts
new file mode 100644
index 0000000..c56cb63
--- /dev/null
+++ b/src/app/how-it-works/build-how-it-works-json-ld.test.ts
@@ -0,0 +1,35 @@
+import { describe, expect, it } from "vitest";
+
+import { HOW_IT_WORKS_VIDEOS } from "@/config";
+
+import { buildHowItWorksJsonLd } from "./build-how-it-works-json-ld";
+
+describe("buildHowItWorksJsonLd", () => {
+ it("includes Google's required video rich-result fields for every tutorial", () => {
+ const graph = JSON.parse(JSON.stringify(buildHowItWorksJsonLd())) as {
+ "@graph": Array<Record<string, unknown>>;
+ };
+
+ const webPage = graph["@graph"].find(
+ (node) => node["@type"] === "WebPage",
+ ) as {
+ mainEntity: {
+ itemListElement: Array<{
+ item: {
+ uploadDate?: string;
+ thumbnailUrl?: string;
+ };
+ }>;
+ };
+ };
+
+ expect(webPage.mainEntity.itemListElement).toHaveLength(
+ HOW_IT_WORKS_VIDEOS.length,
+ );
+
+ webPage.mainEntity.itemListElement.forEach(({ item }, index) => {
+ expect(item.uploadDate).toBe(HOW_IT_WORKS_VIDEOS[index].uploadDate);
+ expect(item.thumbnailUrl).toBe(HOW_IT_WORKS_VIDEOS[index].thumbnailUrl);
+ });
+ });
+});
diff --git a/src/app/how-it-works/build-how-it-works-json-ld.ts b/src/app/how-it-works/build-how-it-works-json-ld.ts
index 5c86cf6..93a19a3 100644
--- a/src/app/how-it-works/build-how-it-works-json-ld.ts
+++ b/src/app/how-it-works/build-how-it-works-json-ld.ts
@@ -23,6 +23,8 @@ export function buildHowItWorksJsonLd(baseUrl = PROD_WEBSITE_URL): Graph {
"@type": "VideoObject" as const,
name: video.title,
description: video.description,
+ uploadDate: video.uploadDate,
+ thumbnailUrl: video.thumbnailUrl,
embedUrl: video.embedUrl,
contentUrl: video.watchUrl,
url: `${pageUrl}#${video.id}`,
diff --git a/src/app/how-it-works/layout.tsx b/src/app/how-it-works/layout.tsx
index 6430c93..9e6c0fd 100644
--- a/src/app/how-it-works/layout.tsx
+++ b/src/app/how-it-works/layout.tsx
@@ -35,6 +35,9 @@ export const metadata: Metadata = {
publisher: "Vlad Sazonau",
alternates: {
canonical: HOW_IT_WORKS_PAGE_URL,
+ types: {
+ "text/markdown": "https://easyinvoicepdf.com/how-it-works.md",
+ },
},
robots: {
index: true,
diff --git a/src/app/how-it-works/page.tsx b/src/app/how-it-works/page.tsx
index 51e52f0..14075a6 100644
--- a/src/app/how-it-works/page.tsx
+++ b/src/app/how-it-works/page.tsx
@@ -38,14 +38,16 @@ export default function HowItWorksPage() {
How EasyInvoicePDF Works
</h1>
<p className="relative z-10 mx-auto mt-6 max-w-2xl text-pretty text-sm text-gray-600 md:text-lg">
- Discover how to create, customize, and send professional PDF
- invoices online with EasyInvoicePDF. Watch step-by-step tutorial
- videos to learn invoice creation, branding, and customization
- tips. Start generating invoices instantly in our{" "}
+ Learn how to create, customize, download, and share professional
+ PDF invoices online with EasyInvoicePDF. These step-by-step videos show you how
+ to use our{" "}
<Link href="/" className={cn(linkClassName)}>
- free online invoice generator
+ free invoice generator
</Link>
- .
+ , save seller and buyer details, add branding, and prepare weekly
+ invoices. Whether you need an invoice maker for a one-off bill or
+ a small business invoice template you can reuse, you can start in
+ seconds.
</p>
</div>
</div>
diff --git a/src/components/__tests__/github-star-cta.test.tsx b/src/components/__tests__/github-star-cta.test.tsx
index f2abce6..72ea746 100644
--- a/src/components/__tests__/github-star-cta.test.tsx
+++ b/src/components/__tests__/github-star-cta.test.tsx
@@ -55,16 +55,41 @@ describe("GitHubStarCTA", () => {
expect(within(link).queryByText("Star on GitHub")).not.toBeInTheDocument();
});
- it("should show two-decimal compact star count for values like 2350", () => {
- const githubStarsCount = 2350;
+ it.each([
+ { githubStarsCount: 1012, expected: "1k" },
+ { githubStarsCount: 1050, expected: "1.1k" },
+ { githubStarsCount: 2350, expected: "2.4k" },
+ ])(
+ "should show $expected for $githubStarsCount stars",
+ ({ githubStarsCount, expected }) => {
+ renderGitHubStarCTA(githubStarsCount);
+
+ const link = screen.getByTestId("github-star-cta-button");
+
+ expect(within(link).getByText(expected)).toBeInTheDocument();
+
+ expect(
+ within(link).queryByText("Star on GitHub"),
+ ).not.toBeInTheDocument();
+ },
+ );
- renderGitHubStarCTA(githubStarsCount);
+ it("should use a narrower minimum width only for two-character star counts", () => {
+ const { rerender } = renderGitHubStarCTA(1012);
- const link = screen.getByTestId("github-star-cta-button");
+ expect(
+ within(screen.getByTestId("github-star-cta-button")).getByText("1k"),
+ ).toHaveClass("min-w-5");
- expect(within(link).getByText("2.35k")).toBeInTheDocument();
+ rerender(
+ <TooltipProvider delayDuration={0}>
+ <GitHubStarCTA githubStarsCount={1050} />
+ </TooltipProvider>,
+ );
- expect(within(link).queryByText("Star on GitHub")).not.toBeInTheDocument();
+ expect(
+ within(screen.getByTestId("github-star-cta-button")).getByText("1.1k"),
+ ).toHaveClass("min-w-[27px]");
});
it("should show unabbreviated star count for three-digit values", () => {
diff --git a/src/components/github-star-cta.tsx b/src/components/github-star-cta.tsx
index 3a2d33a..f86b2af 100644
--- a/src/components/github-star-cta.tsx
+++ b/src/components/github-star-cta.tsx
@@ -6,9 +6,10 @@ import { Star } from "lucide-react";
import { GithubIcon } from "./etc/github-logo";
import { Tooltip, TooltipContent, TooltipTrigger } from "./ui/tooltip";
import { githubStarCountFormatter } from "@/utils/number-formatter";
+import { cn } from "@/lib/utils";
export function GitHubStarCTA({
- githubStarsCount,
+ githubStarsCount = 0,
}: {
githubStarsCount: number;
}) {
@@ -20,6 +21,9 @@ export function GitHubStarCTA({
.format(githubStarsCount)
.toLowerCase();
+ const isTwoCharacterStarCount =
+ githubStarsCount > 0 && gitHubStarCountFormatted.length === 2;
+
return (
<Tooltip>
<TooltipTrigger asChild>
@@ -42,7 +46,12 @@ export function GitHubStarCTA({
</span>
{githubStarsCount > 0 ? (
<>
- <span className="min-w-[27px] text-center text-sm font-medium tabular-nums text-slate-50">
+ <span
+ className={cn(
+ isTwoCharacterStarCount ? "min-w-5" : "min-w-[27px]",
+ "text-center text-sm font-medium tabular-nums text-slate-50",
+ )}
+ >
{gitHubStarCountFormatted}
</span>
</>
diff --git a/src/config.ts b/src/config.ts
index d204864..994777a 100644
--- a/src/config.ts
+++ b/src/config.ts
@@ -46,6 +46,8 @@ export const HOW_IT_WORKS_VIDEOS = [
description: "Learn how to create and customize your invoices.",
embedUrl: VIDEO_DEMO_YOUTUBE_URL,
watchUrl: "https://www.youtube.com/watch?v=iAROeCIcZ40",
+ uploadDate: "2026-04-16T15:49:53-07:00",
+ thumbnailUrl: "https://i.ytimg.com/vi/iAROeCIcZ40/maxresdefault.jpg",
iframeTitle: "EasyInvoicePDF Demo Video",
},
{
@@ -56,6 +58,8 @@ export const HOW_IT_WORKS_VIDEOS = [
description: "Save seller details and reuse them on future invoices.",
embedUrl: YOUTUBE_VIDEO_HOW_TO_ADD_SELLER,
watchUrl: "https://www.youtube.com/watch?v=xfSF35c0vfU",
+ uploadDate: "2026-06-13T13:06:34-07:00",
+ thumbnailUrl: "https://i.ytimg.com/vi/xfSF35c0vfU/maxresdefault.jpg",
iframeTitle: "How to add a seller - EasyInvoicePDF",
},
{
@@ -66,6 +70,8 @@ export const HOW_IT_WORKS_VIDEOS = [
description: "Save buyer details and reuse them on future invoices.",
embedUrl: YOUTUBE_VIDEO_HOW_TO_ADD_BUYER,
watchUrl: "https://www.youtube.com/watch?v=XxAY0YGgXIk",
+ uploadDate: "2026-06-13T13:17:28-07:00",
+ thumbnailUrl: "https://i.ytimg.com/vi/XxAY0YGgXIk/maxresdefault.jpg",
iframeTitle: "How to add a buyer - EasyInvoicePDF",
},
{
@@ -76,6 +82,8 @@ export const HOW_IT_WORKS_VIDEOS = [
description: "Learn how to generate invoices for a week of work.",
embedUrl: YOUTUBE_VIDEO_HOW_TO_ADD_INVOICE_FOR_ONE_WEEK,
watchUrl: "https://www.youtube.com/watch?v=6KzDBBiAJmg",
+ uploadDate: "2026-06-13T13:23:38-07:00",
+ thumbnailUrl: "https://i.ytimg.com/vi/6KzDBBiAJmg/maxresdefault.jpg",
iframeTitle: "How to create weekly invoices - EasyInvoicePDF",
},
] as const satisfies {
@@ -86,6 +94,8 @@ export const HOW_IT_WORKS_VIDEOS = [
description: string;
embedUrl: string;
watchUrl: string;
+ uploadDate: string;
+ thumbnailUrl: string;
iframeTitle: string;
}[];
diff --git a/src/lib/seo/__tests__/llms-markdown-pages.test.ts b/src/lib/seo/__tests__/llms-markdown-pages.test.ts
new file mode 100644
index 0000000..dbcc44c
--- /dev/null
+++ b/src/lib/seo/__tests__/llms-markdown-pages.test.ts
@@ -0,0 +1,50 @@
+import { readFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { describe, expect, it } from "vitest";
+
+const MARKDOWN_PATHS = [
+ "invoice-generator.md",
+ "how-it-works.md",
+ "en/about.md",
+ "pl/about.md",
+ "de/about.md",
+ "es/about.md",
+ "pt/about.md",
+ "ru/about.md",
+ "uk/about.md",
+ "fr/about.md",
+ "it/about.md",
+ "nl/about.md",
+] as const;
+
+function readPublicFile(path: string) {
+ return readFileSync(resolve(process.cwd(), "public", path), "utf8");
+}
+
+describe("LLM-facing Markdown pages", () => {
+ it.each(MARKDOWN_PATHS)("publishes %s with useful source context", (path) => {
+ const content = readPublicFile(path);
+
+ expect(content).toMatch(/^# EasyInvoicePDF|^# .*EasyInvoicePDF/m);
+ expect(content).toContain("https://easyinvoicepdf.com/");
+
+ const updatedAtMatch = /\b(\d{4}-\d{2}-\d{2})\b/.exec(content);
+ expect(updatedAtMatch, "expected a YYYY-MM-DD update date").not.toBeNull();
+
+ const updatedAt = new Date(`${updatedAtMatch?.[1]}T00:00:00Z`);
+ expect(updatedAt.getTime()).not.toBeNaN();
+ expect(updatedAt.getTime()).toBeLessThanOrEqual(Date.now());
+
+ expect(content.length).toBeGreaterThan(1_000);
+ });
+
+ it("lists every Markdown page in llms.txt", () => {
+ const llmsTxt = readPublicFile("llms.txt");
+
+ const linkedPaths = [
+ ...llmsTxt.matchAll(/https:\/\/easyinvoicepdf\.com\/(\S+?\.md)/g),
+ ].map((match) => match[1]);
+
+ expect(new Set(linkedPaths)).toEqual(new Set(MARKDOWN_PATHS));
+ });
+});
diff --git a/src/utils/number-formatter.ts b/src/utils/number-formatter.ts
index 12f2342..69348e7 100644
--- a/src/utils/number-formatter.ts
+++ b/src/utils/number-formatter.ts
@@ -3,12 +3,14 @@
* Converts numbers to abbreviated format (e.g., 1500 -> "1.5K").
*
* @example
+ * githubStarCountFormatter.format(1012); // "1K"
+ * githubStarCountFormatter.format(1050); // "1.1K"
* githubStarCountFormatter.format(1500); // "1.5K"
- * githubStarCountFormatter.format(2350); // "2.35K"
+ * githubStarCountFormatter.format(2350); // "2.4K"
* githubStarCountFormatter.format(1000000); // "1M"
*/
export const githubStarCountFormatter = new Intl.NumberFormat("en-US", {
notation: "compact",
compactDisplay: "short",
- maximumFractionDigits: 2,
+ maximumFractionDigits: 1,
});