Skip to content

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

feat: seo improvements and minor fixes (#221)

Vlad Sazonau86fbea3dcce7
diff --git a/.agents/skills/programmatic-seo/SKILL.md b/.agents/skills/programmatic-seo/SKILL.md
index b3e150e..ff0f0b3 100644
--- a/.agents/skills/programmatic-seo/SKILL.md
+++ b/.agents/skills/programmatic-seo/SKILL.md
@@ -17,11 +17,13 @@ If `.agents/product-marketing-context.md` exists (or `.claude/product-marketing-
Before designing a programmatic SEO strategy, understand:
1. **Business Context**
+
- What's the product/service?
- Who is the target audience?
- What's the conversion goal for these pages?
2. **Opportunity Assessment**
+
- What search patterns exist?
- How many potential pages?
- What's the search volume distribution?
@@ -36,12 +38,15 @@ Before designing a programmatic SEO strategy, understand:
## Core Principles
### 1. Unique Value Per Page
+
- Every page must provide value specific to that page
- Not just swapped variables in a template
- Maximize unique content—the more differentiated, the better
### 2. Proprietary Data Wins
+
Hierarchy of data defensibility:
+
1. Proprietary (you created it)
2. Product-derived (from your users)
3. User-generated (your community)
@@ -49,17 +54,22 @@ Hierarchy of data defensibility:
5. Public (anyone can use—weakest)
### 3. Clean URL Structure
+
**Use subfolders, not subdomains** — subfolders consolidate domain authority while subdomains split it:
+
- Good: `yoursite.com/templates/resume/`
- Bad: `templates.yoursite.com/resume/`
### 4. Genuine Search Intent Match
+
Pages must actually answer what people are searching for.
### 5. Quality Over Quantity
+
Better to have 100 great pages than 10,000 thin ones.
### 6. Avoid Google Penalties
+
- No doorway pages
- No keyword stuffing
- No duplicate content
@@ -69,20 +79,20 @@ Better to have 100 great pages than 10,000 thin ones.
## The 12 Playbooks (Overview)
-| Playbook | Pattern | Example |
-|----------|---------|---------|
-| Templates | "[Type] template" | "resume template" |
-| Curation | "best [category]" | "best website builders" |
-| Conversions | "[X] to [Y]" | "$10 USD to GBP" |
-| Comparisons | "[X] vs [Y]" | "webflow vs wordpress" |
-| Examples | "[type] examples" | "landing page examples" |
-| Locations | "[service] in [location]" | "dentists in austin" |
-| Personas | "[product] for [audience]" | "crm for real estate" |
+| Playbook | Pattern | Example |
+| ------------ | ------------------------------------- | ------------------------- |
+| Templates | "[Type] template" | "resume template" |
+| Curation | "best [category]" | "best website builders" |
+| Conversions | "[X] to [Y]" | "$10 USD to GBP" |
+| Comparisons | "[X] vs [Y]" | "webflow vs wordpress" |
+| Examples | "[type] examples" | "landing page examples" |
+| Locations | "[service] in [location]" | "dentists in austin" |
+| Personas | "[product] for [audience]" | "crm for real estate" |
| Integrations | "[product A] [product B] integration" | "slack asana integration" |
-| Glossary | "what is [term]" | "what is pSEO" |
-| Translations | Content in multiple languages | Localized content |
-| Directory | "[category] tools" | "ai copywriting tools" |
-| Profiles | "[entity name]" | "stripe ceo" |
+| Glossary | "what is [term]" | "what is pSEO" |
+| Translations | Content in multiple languages | Localized content |
+| Directory | "[category] tools" | "ai copywriting tools" |
+| Profiles | "[entity name]" | "stripe ceo" |
**For detailed playbook implementation**: See [references/playbooks.md](references/playbooks.md)
@@ -90,16 +100,16 @@ Better to have 100 great pages than 10,000 thin ones.
## Choosing Your Playbook
-| If you have... | Consider... |
-|----------------|-------------|
-| Proprietary data | Directories, Profiles |
-| Product with integrations | Integrations |
-| Design/creative product | Templates, Examples |
-| Multi-segment audience | Personas |
-| Local presence | Locations |
-| Tool or utility product | Conversions |
-| Content/expertise | Glossary, Curation |
-| Competitor landscape | Comparisons |
+| If you have... | Consider... |
+| ------------------------- | --------------------- |
+| Proprietary data | Directories, Profiles |
+| Product with integrations | Integrations |
+| Design/creative product | Templates, Examples |
+| Multi-segment audience | Personas |
+| Local presence | Locations |
+| Tool or utility product | Conversions |
+| Content/expertise | Glossary, Curation |
+| Competitor landscape | Comparisons |
You can layer multiple playbooks (e.g., "Best coworking spaces in San Diego").
@@ -110,11 +120,13 @@ You can layer multiple playbooks (e.g., "Best coworking spaces in San Diego").
### 1. Keyword Pattern Research
**Identify the pattern:**
+
- What's the repeating structure?
- What are the variables?
- How many unique combinations exist?
**Validate demand:**
+
- Aggregate search volume
- Volume distribution (head vs. long tail)
- Trend direction
@@ -122,6 +134,7 @@ You can layer multiple playbooks (e.g., "Best coworking spaces in San Diego").
### 2. Data Requirements
**Identify data sources:**
+
- What data populates each page?
- Is it first-party, scraped, licensed, public?
- How is it updated?
@@ -129,6 +142,7 @@ You can layer multiple playbooks (e.g., "Best coworking spaces in San Diego").
### 3. Template Design
**Page structure:**
+
- Header with target keyword
- Unique intro (not just variables swapped)
- Data-driven sections
@@ -136,6 +150,7 @@ You can layer multiple playbooks (e.g., "Best coworking spaces in San Diego").
- CTAs appropriate to intent
**Ensuring uniqueness:**
+
- Each page needs unique value
- Conditional content based on data
- Original insights/analysis per page
@@ -143,11 +158,13 @@ You can layer multiple playbooks (e.g., "Best coworking spaces in San Diego").
### 4. Internal Linking Architecture
**Hub and spoke model:**
+
- Hub: Main category page
- Spokes: Individual programmatic pages
- Cross-links between related spokes
**Avoid orphan pages:**
+
- Every page reachable from main site
- XML sitemap for all pages
- Breadcrumbs with structured data
@@ -166,22 +183,26 @@ You can layer multiple playbooks (e.g., "Best coworking spaces in San Diego").
### Pre-Launch Checklist
**Content quality:**
+
- [ ] Each page provides unique value
- [ ] Answers search intent
- [ ] Readable and useful
**Technical SEO:**
+
- [ ] Unique titles and meta descriptions
- [ ] Proper heading structure
- [ ] Schema markup implemented
- [ ] Page speed acceptable
**Internal linking:**
+
- [ ] Connected to site architecture
- [ ] Related pages linked
- [ ] No orphan pages
**Indexation:**
+
- [ ] In XML sitemap
- [ ] Crawlable
- [ ] No conflicting noindex
@@ -207,11 +228,13 @@ Watch for: Thin content warnings, Ranking drops, Manual actions, Crawl errors
## Output Format
### Strategy Document
+
- Opportunity analysis
- Implementation plan
- Content guidelines
### Page Template
+
- URL structure
- Title/meta templates
- Content outline
diff --git a/.agents/skills/programmatic-seo/references/playbooks.md b/.agents/skills/programmatic-seo/references/playbooks.md
index 35c354c..2d335de 100644
--- a/.agents/skills/programmatic-seo/references/playbooks.md
+++ b/.agents/skills/programmatic-seo/references/playbooks.md
@@ -3,6 +3,7 @@
Beyond mixing and matching data point permutations, these are the proven playbooks for programmatic SEO.
## Contents
+
- 1. Templates
- 2. Curation
- 3. Conversions
@@ -25,11 +26,13 @@ Beyond mixing and matching data point permutations, these are the proven playboo
**What it is**: Downloadable or interactive templates users can use directly.
**Why it works**:
+
- High intent—people need it now
- Shareable/linkable assets
- Natural for product-led companies
**Value requirements**:
+
- Actually usable templates (not just previews)
- Multiple variations per type
- Quality comparable to paid options
@@ -47,11 +50,13 @@ Beyond mixing and matching data point permutations, these are the proven playboo
**What it is**: Curated lists ranking or recommending options in a category.
**Why it works**:
+
- Comparison shoppers searching for guidance
- High commercial intent
- Evergreen with updates
**Value requirements**:
+
- Genuine evaluation criteria
- Real testing or expertise
- Regular updates (date visible)
@@ -69,11 +74,13 @@ Beyond mixing and matching data point permutations, these are the proven playboo
**What it is**: Tools or pages that convert between formats, units, or currencies.
**Why it works**:
+
- Instant utility
- Extremely high search volume
- Repeat usage potential
**Value requirements**:
+
- Accurate, real-time data
- Fast, functional tool
- Related conversions suggested
@@ -91,11 +98,13 @@ Beyond mixing and matching data point permutations, these are the proven playboo
**What it is**: Head-to-head comparisons between products, tools, or options.
**Why it works**:
+
- High purchase intent
- Clear search pattern
- Scales with number of competitors
**Value requirements**:
+
- Honest, balanced analysis
- Actual feature comparison data
- Clear recommendation by use case
@@ -103,7 +112,7 @@ Beyond mixing and matching data point permutations, these are the proven playboo
**URL structure**: `/compare/[x]-vs-[y]/` or `/[x]-vs-[y]/`
-*See also: competitor-alternatives skill for detailed frameworks*
+_See also: competitor-alternatives skill for detailed frameworks_
---
@@ -115,11 +124,13 @@ Beyond mixing and matching data point permutations, these are the proven playboo
**What it is**: Galleries or collections of real-world examples for inspiration.
**Why it works**:
+
- Research phase traffic
- Highly shareable
- Natural for design/creative tools
**Value requirements**:
+
- Real, high-quality examples
- Screenshots or embeds
- Categorization/filtering
@@ -137,11 +148,13 @@ Beyond mixing and matching data point permutations, these are the proven playboo
**What it is**: Location-specific pages for services, businesses, or information.
**Why it works**:
+
- Local intent is massive
- Scales with geography
- Natural for marketplaces/directories
**Value requirements**:
+
- Actual local data (not just city name swapped)
- Local providers/options listed
- Location-specific insights (pricing, regulations)
@@ -159,11 +172,13 @@ Beyond mixing and matching data point permutations, these are the proven playboo
**What it is**: Tailored landing pages addressing specific audience segments.
**Why it works**:
+
- Speaks directly to searcher's context
- Higher conversion than generic pages
- Scales with personas
**Value requirements**:
+
- Genuine persona-specific content
- Relevant features highlighted
- Testimonials from that segment
@@ -181,11 +196,13 @@ Beyond mixing and matching data point permutations, these are the proven playboo
**What it is**: Pages explaining how your product works with other tools.
**Why it works**:
+
- Captures users of other products
- High intent (they want the solution)
- Scales with integration ecosystem
**Value requirements**:
+
- Real integration details
- Setup instructions
- Use cases for the combination
@@ -203,11 +220,13 @@ Beyond mixing and matching data point permutations, these are the proven playboo
**What it is**: Educational definitions of industry terms and concepts.
**Why it works**:
+
- Top-of-funnel awareness
- Establishes expertise
- Natural internal linking opportunities
**Value requirements**:
+
- Clear, accurate definitions
- Examples and context
- Related terms linked
@@ -225,11 +244,13 @@ Beyond mixing and matching data point permutations, these are the proven playboo
**What it is**: Your content translated and localized for other language markets.
**Why it works**:
+
- Opens entirely new markets
- Lower competition in many languages
- Multiplies your content reach
**Value requirements**:
+
- Quality translation (not just Google Translate)
- Cultural localization
- hreflang tags properly implemented
@@ -247,11 +268,13 @@ Beyond mixing and matching data point permutations, these are the proven playboo
**What it is**: Comprehensive directories listing options in a category.
**Why it works**:
+
- Research phase capture
- Link building magnet
- Natural for aggregators/reviewers
**Value requirements**:
+
- Comprehensive coverage
- Useful filtering/sorting
- Details per listing (not just names)
@@ -269,11 +292,13 @@ Beyond mixing and matching data point permutations, these are the proven playboo
**What it is**: Profile pages about notable people, companies, or entities.
**Why it works**:
+
- Informational intent traffic
- Builds topical authority
- Natural for B2B, news, research
**Value requirements**:
+
- Accurate, sourced information
- Regularly updated
- Unique insights or aggregation
@@ -287,21 +312,22 @@ Beyond mixing and matching data point permutations, these are the proven playboo
### Match to Your Assets
-| If you have... | Consider... |
-|----------------|-------------|
-| Proprietary data | Stats, Directories, Profiles |
-| Product with integrations | Integrations |
-| Design/creative product | Templates, Examples |
-| Multi-segment audience | Personas |
-| Local presence | Locations |
-| Tool or utility product | Conversions |
-| Content/expertise | Glossary, Curation |
-| International potential | Translations |
-| Competitor landscape | Comparisons |
+| If you have... | Consider... |
+| ------------------------- | ---------------------------- |
+| Proprietary data | Stats, Directories, Profiles |
+| Product with integrations | Integrations |
+| Design/creative product | Templates, Examples |
+| Multi-segment audience | Personas |
+| Local presence | Locations |
+| Tool or utility product | Conversions |
+| Content/expertise | Glossary, Curation |
+| International potential | Translations |
+| Competitor landscape | Comparisons |
### Combine Playbooks
You can layer multiple playbooks:
+
- **Locations + Personas**: "Marketing agencies for startups in Austin"
- **Curation + Locations**: "Best coworking spaces in San Diego"
- **Integrations + Personas**: "Slack for sales teams"
diff --git a/.agents/skills/seo-audit/SKILL.md b/.agents/skills/seo-audit/SKILL.md
index 78c8241..068098e 100644
--- a/.agents/skills/seo-audit/SKILL.md
+++ b/.agents/skills/seo-audit/SKILL.md
@@ -17,11 +17,13 @@ If `.agents/product-marketing-context.md` exists (or `.claude/product-marketing-
Before auditing, understand:
1. **Site Context**
+
- What type of site? (SaaS, e-commerce, blog, etc.)
- What's the primary business goal for SEO?
- What keywords/topics are priorities?
2. **Current State**
+
- Any known issues or concerns?
- Current organic traffic level?
- Recent changes or migrations?
@@ -42,6 +44,7 @@ Before auditing, understand:
Many CMS plugins (AIOSEO, Yoast, RankMath) inject JSON-LD via client-side JavaScript — it won't appear in static HTML or `web_fetch` output (which strips `<script>` tags during conversion).
**To accurately check for schema markup, use one of these methods:**
+
1. **Browser tool** — render the page and run: `document.querySelectorAll('script[type="application/ld+json"]')`
2. **Google Rich Results Test** — https://search.google.com/test/rich-results
3. **Screaming Frog export** — if the client provides one, use it (SF renders JavaScript)
@@ -49,6 +52,7 @@ Many CMS plugins (AIOSEO, Yoast, RankMath) inject JSON-LD via client-side JavaSc
Reporting "no schema found" based solely on `web_fetch` or `curl` leads to false audit findings — these tools can't see JS-injected schema.
### Priority Order
+
1. **Crawlability & Indexation** (can Google find and index it?)
2. **Technical Foundations** (is the site fast and functional?)
3. **On-Page Optimization** (is content optimized?)
@@ -62,11 +66,13 @@ Reporting "no schema found" based solely on `web_fetch` or `curl` leads to false
### Crawlability
**Robots.txt**
+
- Check for unintentional blocks
- Verify important pages allowed
- Check sitemap reference
**XML Sitemap**
+
- Exists and accessible
- Submitted to Search Console
- Contains only canonical, indexable URLs
@@ -74,12 +80,14 @@ Reporting "no schema found" based solely on `web_fetch` or `curl` leads to false
- Proper formatting
**Site Architecture**
+
- Important pages within 3 clicks of homepage
- Logical hierarchy
- Internal linking structure
- No orphan pages
**Crawl Budget Issues** (for large sites)
+
- Parameterized URLs under control
- Faceted navigation handled properly
- Infinite scroll with pagination fallback
@@ -88,11 +96,13 @@ Reporting "no schema found" based solely on `web_fetch` or `curl` leads to false
### Indexation
**Index Status**
+
- site:domain.com check
- Search Console coverage report
- Compare indexed vs. expected
**Indexation Issues**
+
- Noindex tags on important pages
- Canonicals pointing wrong direction
- Redirect chains/loops
@@ -100,6 +110,7 @@ Reporting "no schema found" based solely on `web_fetch` or `curl` leads to false
- Duplicate content without canonicals
**Canonicalization**
+
- All pages have canonical tags
- Self-referencing canonicals on unique pages
- HTTP → HTTPS canonicals
@@ -109,11 +120,13 @@ Reporting "no schema found" based solely on `web_fetch` or `curl` leads to false
### Site Speed & Core Web Vitals
**Core Web Vitals**
+
- LCP (Largest Contentful Paint): < 2.5s
- INP (Interaction to Next Paint): < 200ms
- CLS (Cumulative Layout Shift): < 0.1
**Speed Factors**
+
- Server response time (TTFB)
- Image optimization
- JavaScript execution
@@ -123,6 +136,7 @@ Reporting "no schema found" based solely on `web_fetch` or `curl` leads to false
- Font loading
**Tools**
+
- PageSpeed Insights
- WebPageTest
- Chrome DevTools
@@ -164,6 +178,7 @@ Check when the site serves multiple languages or regions. Misconfigurations can
Three equivalent placement methods: HTML `<link>` in `<head>`, HTTP `Link` headers, XML sitemap `<xhtml:link>`. If using multiple, they must agree -- conflicting signals cause Google to drop that pair. For 10+ locales, prefer sitemap-based (no page weight, no per-request cost).
**Check for:**
+
- Self-referencing entry on every page (page must include itself in the hreflang set)
- Reciprocal links (if A points to B, B must point back to A -- or both are ignored)
- Valid codes: ISO 639-1 language + optional ISO 3166-1 Alpha 2 region (e.g., `en`, `en-GB` -- never `en-UK`)
@@ -189,6 +204,7 @@ Three equivalent placement methods: HTML `<link>` in `<head>`, HTTP `Link` heade
### International Sitemaps
**Check for:**
+
- `xmlns:xhtml` namespace on `<urlset>`, each `<url>` includes `<xhtml:link>` for all locales including itself
- `x-default` alternate included; all URLs absolute (full protocol + domain)
- Sitemap index in Search Console and robots.txt; split by content type, not by locale
@@ -200,6 +216,7 @@ Three equivalent placement methods: HTML `<link>` in `<head>`, HTTP `Link` heade
**Recommended:** Subdirectories (`/en/`, `/ar/`). **Acceptable:** Subdomains or ccTLDs. **Not recommended:** URL parameters (`?lang=en`).
**Check for:**
+
- Consistent locale prefix strategy; all locales prefixed (hiding locale from URLs prevents Google from distinguishing versions)
- Root URL handled as `x-default` with redirect, or serves default locale content
- No IP/Accept-Language content negotiation (Googlebot: US IPs, no Accept-Language header)
@@ -211,16 +228,19 @@ Three equivalent placement methods: HTML `<link>` in `<head>`, HTTP `Link` heade
### Content Quality Across Locales
**Translation quality:**
+
- AI-translated content is not inherently spam (Google's 2025 stance), but scaled low-value translations can trigger scaled content abuse policy
- Google uses visible content to determine language -- translate ALL page content (title, description, headings, body), not just boilerplate
- Translating only template/nav while main content stays in original language creates duplicates
**Thin locale pages:**
+
- Helpful content system is site-wide -- many thin locale pages can suppress rankings for strong pages too
- Don't noindex thin locales (wastes crawl budget) or cross-locale canonical (conflicts with hreflang)
- Best approach: don't create locale pages you cannot make genuinely helpful
**Check for:**
+
- All locale pages have fully translated main content (not just UI chrome)
- No near-identical content across locales ("Duplicate, Google chose different canonical" in GSC)
- Hreflang only for locales with genuine content and search demand
@@ -234,6 +254,7 @@ Three equivalent placement methods: HTML `<link>` in `<head>`, HTTP `Link` heade
### Title Tags
**Check for:**
+
- Unique titles for each page
- Primary keyword near beginning
- 50-60 characters (visible in SERP)
@@ -241,6 +262,7 @@ Three equivalent placement methods: HTML `<link>` in `<head>`, HTTP `Link` heade
- Brand name placement (end, usually)
**Common issues:**
+
- Duplicate titles
- Too long (truncated)
- Too short (wasted opportunity)
@@ -250,6 +272,7 @@ Three equivalent placement methods: HTML `<link>` in `<head>`, HTTP `Link` heade
### Meta Descriptions
**Check for:**
+
- Unique descriptions per page
- 150-160 characters
- Includes primary keyword
@@ -257,6 +280,7 @@ Three equivalent placement methods: HTML `<link>` in `<head>`, HTTP `Link` heade
- Call to action
**Common issues:**
+
- Duplicate descriptions
- Auto-generated garbage
- Too long/short
@@ -265,6 +289,7 @@ Three equivalent placement methods: HTML `<link>` in `<head>`, HTTP `Link` heade
### Heading Structure
**Check for:**
+
- One H1 per page
- H1 contains primary keyword
- Logical hierarchy (H1 → H2 → H3)
@@ -272,6 +297,7 @@ Three equivalent placement methods: HTML `<link>` in `<head>`, HTTP `Link` heade
- Not just for styling
**Common issues:**
+
- Multiple H1s
- Skip levels (H1 → H3)
- Headings used for styling only
@@ -280,6 +306,7 @@ Three equivalent placement methods: HTML `<link>` in `<head>`, HTTP `Link` heade
### Content Optimization
**Primary Page Content**
+
- Keyword in first 100 words
- Related keywords naturally used
- Sufficient depth/length for topic
@@ -287,6 +314,7 @@ Three equivalent placement methods: HTML `<link>` in `<head>`, HTTP `Link` heade
- Better than competitors
**Thin Content Issues**
+
- Pages with little unique content
- Tag/category pages with no value
- Doorway pages
@@ -295,6 +323,7 @@ Three equivalent placement methods: HTML `<link>` in `<head>`, HTTP `Link` heade
### Image Optimization
**Check for:**
+
- Descriptive file names
- Alt text on all images
- Alt text describes image
@@ -306,6 +335,7 @@ Three equivalent placement methods: HTML `<link>` in `<head>`, HTTP `Link` heade
### Internal Linking
**Check for:**
+
- Important pages well-linked
- Descriptive anchor text
- Logical link relationships
@@ -313,6 +343,7 @@ Three equivalent placement methods: HTML `<link>` in `<head>`, HTTP `Link` heade
- Reasonable link count per page
**Common issues:**
+
- Orphan pages (no internal links)
- Over-optimized anchor text
- Important pages buried
@@ -321,12 +352,14 @@ Three equivalent placement methods: HTML `<link>` in `<head>`, HTTP `Link` heade
### Keyword Targeting
**Per Page**
+
- Clear primary keyword target
- Title, H1, URL aligned
- Content satisfies search intent
- Not competing with other pages (cannibalization)
**Site-Wide**
+
- Keyword mapping document
- No major gaps in coverage
- No keyword cannibalization
@@ -339,21 +372,25 @@ Three equivalent placement methods: HTML `<link>` in `<head>`, HTTP `Link` heade
### E-E-A-T Signals
**Experience**
+
- First-hand experience demonstrated
- Original insights/data
- Real examples and case studies
**Expertise**
+
- Author credentials visible
- Accurate, detailed information
- Properly sourced claims
**Authoritativeness**
+
- Recognized in the space
- Cited by others
- Industry credentials
**Trustworthiness**
+
- Accurate information
- Transparent about business
- Contact information available
@@ -379,6 +416,7 @@ Three equivalent placement methods: HTML `<link>` in `<head>`, HTTP `Link` heade
## Common Issues by Site Type
### SaaS/Product Sites
+
- Product pages lack content depth
- Blog not integrated with product pages
- Missing comparison/alternative pages
@@ -386,6 +424,7 @@ Three equivalent placement methods: HTML `<link>` in `<head>`, HTTP `Link` heade
- No glossary/educational content
### E-commerce
+
- Thin category pages
- Duplicate product descriptions
- Missing product schema
@@ -393,6 +432,7 @@ Three equivalent placement methods: HTML `<link>` in `<head>`, HTTP `Link` heade
- Out-of-stock pages mishandled
### Content/Blog Sites
+
- Outdated content not refreshed
- Keyword cannibalization
- No topical clustering
@@ -400,6 +440,7 @@ Three equivalent placement methods: HTML `<link>` in `<head>`, HTTP `Link` heade
- Missing author pages
### Multilingual / Multi-Regional Sites
+
- Hreflang errors (missing return tags, invalid codes, no self-reference)
- Canonical conflicting with hreflang (cross-locale canonical suppresses indexing)
- Thin locale pages dragging down site-wide quality signal
@@ -410,6 +451,7 @@ Three equivalent placement methods: HTML `<link>` in `<head>`, HTTP `Link` heade
- Framework locale mode hiding locale from URLs
### Local Business
+
- Inconsistent NAP
- Missing local schema
- No Google Business Profile optimization
@@ -423,12 +465,14 @@ Three equivalent placement methods: HTML `<link>` in `<head>`, HTTP `Link` heade
### Audit Report Structure
**Executive Summary**
+
- Overall health assessment
- Top 3-5 priority issues
- Quick wins identified
**Technical SEO Findings**
For each issue:
+
- **Issue**: What's wrong
- **Impact**: SEO impact (High/Medium/Low)
- **Evidence**: How you found it
@@ -442,6 +486,7 @@ Same format as above
Same format as above
**Prioritized Action Plan**
+
1. Critical fixes (blocking indexation/ranking)
2. High-impact improvements
3. Quick wins (easy, immediate benefit)
@@ -460,6 +505,7 @@ Same format as above
## Tools Referenced
**Free Tools**
+
- Google Search Console (essential)
- Google PageSpeed Insights
- Bing Webmaster Tools
@@ -470,6 +516,7 @@ Same format as above
> **Note on schema detection:** `web_fetch` strips `<script>` tags (including JSON-LD) and cannot detect JS-injected schema. Use the browser tool, Rich Results Test, or Screaming Frog instead — they render JavaScript and capture dynamically-injected markup. See the Schema Markup Detection Limitation section above.
**Paid Tools** (if available)
+
- Screaming Frog
- Ahrefs / Semrush
- Sitebulb
diff --git a/.agents/skills/seo-audit/references/ai-writing-detection.md b/.agents/skills/seo-audit/references/ai-writing-detection.md
index cb67ece..aff2391 100644
--- a/.agents/skills/seo-audit/references/ai-writing-detection.md
+++ b/.agents/skills/seo-audit/references/ai-writing-detection.md
@@ -7,6 +7,7 @@ Sources: Grammarly (2025), Microsoft 365 Life Hacks (2025), GPTHuman (2025), Wal
---
## Contents
+
- Em Dashes: The Primary AI Tell
- Overused Verbs
- Overused Adjectives
@@ -23,20 +24,23 @@ Sources: Grammarly (2025), Microsoft 365 Life Hacks (2025), GPTHuman (2025), Wal
Em dashes are longer than hyphens (-) and are used for emphasis, interruptions, or parenthetical information. While they have legitimate uses in writing, AI models drastically overuse them.
### Why Em Dashes Signal AI Writing
+
- AI models were trained on edited books, academic papers, and style guides where em dashes appear frequently
- AI uses em dashes as a shortcut for sentence variety instead of commas, colons, or parentheses
- Most human writers rarely use em dashes because they don't exist as a standard keyboard key
- The overuse is so consistent that it has become the unofficial signature of ChatGPT writing
### What To Do Instead
-| Instead of | Use |
-|------------|-----|
-| The results—which were surprising—showed... | The results, which were surprising, showed... |
-| This approach—unlike traditional methods—allows... | This approach, unlike traditional methods, allows... |
-| The study found—as expected—that... | The study found, as expected, that... |
+
+| Instead of | Use |
+| ---------------------------------------------------------- | ------------------------------------------------------------ |
+| The results—which were surprising—showed... | The results, which were surprising, showed... |
+| This approach—unlike traditional methods—allows... | This approach, unlike traditional methods, allows... |
+| The study found—as expected—that... | The study found, as expected, that... |
| Communication skills—both written and verbal—are essential | Communication skills (both written and verbal) are essential |
### Guidelines
+
- Use commas for most parenthetical information
- Use colons to introduce explanations or lists
- Use parentheses for supplementary information
@@ -47,67 +51,68 @@ Em dashes are longer than hyphens (-) and are used for emphasis, interruptions,
## Overused Verbs
-| Avoid | Use Instead |
-|-------|-------------|
+| Avoid | Use Instead |
+| ------------ | -------------------------------------- |
| delve (into) | explore, examine, investigate, look at |
-| leverage | use, apply, draw on |
-| optimise | improve, refine, enhance |
-| utilise | use |
-| facilitate | help, enable, support |
-| foster | encourage, support, develop, nurture |
-| bolster | strengthen, support, reinforce |
-| underscore | emphasise, highlight, stress |
-| unveil | reveal, show, introduce, present |
-| navigate | manage, handle, work through |
-| streamline | simplify, make more efficient |
-| enhance | improve, strengthen |
-| endeavour | try, attempt, effort |
-| ascertain | find out, determine, establish |
-| elucidate | explain, clarify, make clear |
+| leverage | use, apply, draw on |
+| optimise | improve, refine, enhance |
+| utilise | use |
+| facilitate | help, enable, support |
+| foster | encourage, support, develop, nurture |
+| bolster | strengthen, support, reinforce |
+| underscore | emphasise, highlight, stress |
+| unveil | reveal, show, introduce, present |
+| navigate | manage, handle, work through |
+| streamline | simplify, make more efficient |
+| enhance | improve, strengthen |
+| endeavour | try, attempt, effort |
+| ascertain | find out, determine, establish |
+| elucidate | explain, clarify, make clear |
---
## Overused Adjectives
-| Avoid | Use Instead |
-|-------|-------------|
-| robust | strong, reliable, thorough, solid |
-| comprehensive | complete, thorough, full, detailed |
-| pivotal | key, critical, central, important |
-| crucial | important, key, essential, critical |
-| vital | important, essential, necessary |
-| transformative | significant, important, major |
-| cutting-edge | new, advanced, recent, modern |
-| groundbreaking | new, original, significant |
-| innovative | new, original, creative |
-| seamless | smooth, easy, effortless |
-| intricate | complex, detailed, complicated |
-| nuanced | subtle, complex, detailed |
-| multifaceted | complex, varied, diverse |
-| holistic | complete, whole, comprehensive |
+| Avoid | Use Instead |
+| -------------- | ----------------------------------- |
+| robust | strong, reliable, thorough, solid |
+| comprehensive | complete, thorough, full, detailed |
+| pivotal | key, critical, central, important |
+| crucial | important, key, essential, critical |
+| vital | important, essential, necessary |
+| transformative | significant, important, major |
+| cutting-edge | new, advanced, recent, modern |
+| groundbreaking | new, original, significant |
+| innovative | new, original, creative |
+| seamless | smooth, easy, effortless |
+| intricate | complex, detailed, complicated |
+| nuanced | subtle, complex, detailed |
+| multifaceted | complex, varied, diverse |
+| holistic | complete, whole, comprehensive |
---
## Overused Transitions and Connectors
-| Avoid | Use Instead |
-|-------|-------------|
-| furthermore | also, in addition, and |
-| moreover | also, and, besides |
-| notwithstanding | despite, even so, still |
-| that being said | however, but, still |
-| at its core | essentially, fundamentally, basically |
-| to put it simply | in short, simply put |
-| it is worth noting that | note that, importantly |
-| in the realm of | in, within, regarding |
-| in the landscape of | in, within |
-| in today's [anything] | currently, now, today |
+| Avoid | Use Instead |
+| ----------------------- | ------------------------------------- |
+| furthermore | also, in addition, and |
+| moreover | also, and, besides |
+| notwithstanding | despite, even so, still |
+| that being said | however, but, still |
+| at its core | essentially, fundamentally, basically |
+| to put it simply | in short, simply put |
+| it is worth noting that | note that, importantly |
+| in the realm of | in, within, regarding |
+| in the landscape of | in, within |
+| in today's [anything] | currently, now, today |
---
## Phrases That Signal AI Writing
### Opening Phrases to Avoid
+
- "In today's fast-paced world..."
- "In today's digital age..."
- "In an era of..."
@@ -118,6 +123,7 @@ Em dashes are longer than hyphens (-) and are used for emphasis, interruptions,
- "Imagine a world where..."
### Transitional Phrases to Avoid
+
- "That being said..."
- "With that in mind..."
- "It's worth mentioning that..."
@@ -127,6 +133,7 @@ Em dashes are longer than hyphens (-) and are used for emphasis, interruptions,
- "This begs the question..."
### Concluding Phrases to Avoid
+
- "In conclusion..."
- "To sum up..."
- "By [doing X], you can [achieve Y]..."
@@ -135,6 +142,7 @@ Em dashes are longer than hyphens (-) and are used for emphasis, interruptions,
- "At the end of the day..."
### Structural Patterns to Avoid
+
- "Whether you're a [X], [Y], or [Z]..." (listing three examples after "whether")
- "It's not just [X], it's also [Y]..."
- "Think of [X] as [elaborate metaphor]..."
@@ -173,20 +181,20 @@ These words often add nothing to meaning. Remove them or find specific alternati
## Academic-Specific AI Tells
-| Avoid | Use Instead |
-|-------|-------------|
-| shed light on | clarify, explain, reveal |
-| pave the way for | enable, allow, make possible |
-| a myriad of | many, numerous, various |
-| a plethora of | many, numerous, several |
-| paramount | very important, essential, critical |
-| pertaining to | about, regarding, concerning |
-| prior to | before |
-| subsequent to | after |
-| in light of | because of, given, considering |
-| with respect to | about, regarding, for |
-| in terms of | regarding, for, about |
-| the fact that | that (or rewrite sentence) |
+| Avoid | Use Instead |
+| ---------------- | ----------------------------------- |
+| shed light on | clarify, explain, reveal |
+| pave the way for | enable, allow, make possible |
+| a myriad of | many, numerous, various |
+| a plethora of | many, numerous, several |
+| paramount | very important, essential, critical |
+| pertaining to | about, regarding, concerning |
+| prior to | before |
+| subsequent to | after |
+| in light of | because of, given, considering |
+| with respect to | about, regarding, for |
+| in terms of | regarding, for, about |
+| the fact that | that (or rewrite sentence) |
---
diff --git a/.github/workflows/e2e.yml b/.github/workflows/e2e.yml
index 75e4b89..9a00847 100644
--- a/.github/workflows/e2e.yml
+++ b/.github/workflows/e2e.yml
@@ -53,7 +53,7 @@ jobs:
NEXT_PUBLIC_SENTRY_ENABLED: false
continue-on-error: true
# https://playwright.dev/docs/test-reporters#line-reporter
- run: pnpm exec playwright test --reporter=html,dot
+ run: pnpm exec playwright test --reporter=html,list
- uses: actions/upload-artifact@bbbca2ddaa5d8feaa63e36b76fdaad77386f024f # v7.0.0
name: 🎲 Upload Playwright report
@@ -77,8 +77,8 @@ jobs:
echo "pr_url=$PR_URL" >> "$GITHUB_OUTPUT"
- name: 📧 Send email
- ## send email only if the workflow is not cancelled (success or failure)
- if: always() && !cancelled()
+ ## always notify; subject/body reflect cancellation vs pass/fail
+ if: always()
# https://github.com/dawidd6/action-send-mail
uses: dawidd6/action-send-mail@d38f3f7cd391cdebfe0d38efc3998b935e951c4f # v16
with:
@@ -88,17 +88,17 @@ jobs:
to: ${{ secrets.EMAIL_USERNAME }}
username: ${{ secrets.EMAIL_USERNAME }}
password: ${{ secrets.EMAIL_PASSWORD }}
- subject: ${{ steps.playwright.outcome == 'success' && '✅ E2E Tests Passed' || '❌ E2E Tests Failed' }} for ${{ github.repository }}
+ subject: ${{ job.status == 'cancelled' && '⚠️ E2E Tests Cancelled' || (steps.playwright.outcome == 'success' && '✅ E2E Tests Passed' || '❌ E2E Tests Failed') }} for ${{ github.repository }}
body: |
E2E tests for ${{ github.repository }} have completed.
- Result: ${{ steps.playwright.outcome == 'success' && '✅ Passed' || '❌ Failed' }}
+ Result: ${{ job.status == 'cancelled' && '⚠️ Cancelled' || (steps.playwright.outcome == 'success' && '✅ Passed' || '❌ Failed') }}
For more details, please check:
- GitHub Actions run: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}
${{ steps.pr-url.outputs.pr_url && format('- Pull Request: {0}', steps.pr-url.outputs.pr_url) }}
- Vercel deployment: ${{ github.event.deployment_status.environment_url }}
- attachments: playwright-output/report/index.html
+ attachments: ${{ job.status != 'cancelled' && 'playwright-output/report/index.html' || '' }}
- name: ❌ Mark workflow failed on E2E Tests failure
if: steps.playwright.outcome == 'failure'
diff --git a/README.md b/README.md
index 120630e..a8bc48f 100644
--- a/README.md
+++ b/README.md
@@ -28,6 +28,7 @@
- 📺 **Live PDF Preview**: See changes in real-time as you type
- ⭐ **No Sign-Up Required**: Start creating invoices immediately without any registration
- 📄 **Instant PDF**: One-click download ready for printing or sending
+- 🎨 **Custom Logo Upload**: Add your company branding with easy logo upload
- 🔗 **Shareable Links**: Send invoices directly to clients without attachments
- 🎨 **Multiple Templates**: Including modern **Stripe-style design**
- 🌍 **Multi-Language & Currency**: Support for 10+ languages and 120+ currencies
diff --git a/e2e/about.test.ts b/e2e/about.test.ts
index 256ce55..1e1f850 100644
--- a/e2e/about.test.ts
+++ b/e2e/about.test.ts
@@ -144,7 +144,9 @@ test.describe("About page", () => {
).toBeVisible();
await expect(faqSection.getByText("What is EasyInvoicePDF?")).toBeVisible();
- await expect(faqSection.getByText("Is it really free?")).toBeVisible();
+ await expect(
+ faqSection.getByText("Is EasyInvoicePDF free to use?"),
+ ).toBeVisible();
// Check footer
const footer = page.getByRole("contentinfo");
diff --git a/e2e/invoice-form.test.ts b/e2e/invoice-form.test.ts
index a417898..bf337d9 100644
--- a/e2e/invoice-form.test.ts
+++ b/e2e/invoice-form.test.ts
@@ -58,13 +58,13 @@ test.describe("Invoice Generator Page", () => {
// Check other meta tags for Stripe template
await expect(page.locator('meta[property="og:title"]')).toHaveAttribute(
"content",
- "Create Invoice — EasyInvoicePDF",
+ "Free Invoice PDF Generator | EasyInvoicePDF",
);
await expect(
page.locator('meta[property="og:description"]'),
).toHaveAttribute(
"content",
- "Create and download professional invoices instantly with EasyInvoicePDF.com. Free and open-source. No signup required.",
+ "Create invoices online for free with our PDF invoice generator. Customize templates, download instantly, no signup required.",
);
await expect(page.locator('meta[property="og:site_name"]')).toHaveAttribute(
"content",
@@ -80,7 +80,7 @@ test.describe("Invoice Generator Page", () => {
).toHaveAttribute("content", "630");
await expect(page.locator('meta[property="og:image:alt"]')).toHaveAttribute(
"content",
- "EasyInvoicePDF.com - Free Invoice PDF Generator",
+ "Default Invoice Template - EasyInvoicePDF.com",
);
});
@@ -89,7 +89,9 @@ test.describe("Invoice Generator Page", () => {
await expect(page).toHaveURL("/?template=default");
// Check title and branding
- await expect(page).toHaveTitle("Create Invoice — EasyInvoicePDF");
+ await expect(page).toHaveTitle(
+ "Free Invoice PDF Generator | EasyInvoicePDF",
+ );
const header = page.getByTestId("header");
await expect(header).toBeVisible();
diff --git a/e2e/stripe-invoice-template/share-logic.test.ts b/e2e/stripe-invoice-template/share-logic.test.ts
index fd333c1..99c45d2 100644
--- a/e2e/stripe-invoice-template/share-logic.test.ts
+++ b/e2e/stripe-invoice-template/share-logic.test.ts
@@ -44,6 +44,12 @@ test.describe("Stripe Invoice Sharing Logic", () => {
expect(dataParam).toBeTruthy();
expect(dataParam).not.toBe("");
+ // Verify that the shared URL is not indexed by search engines (to prevent sensitive data from being indexed)
+ await expect(page.locator('meta[name="robots"]')).toHaveAttribute(
+ "content",
+ "noindex, nofollow",
+ );
+
// ------------------------------------------------------------
// Open URL in new tab
// ------------------------------------------------------------
@@ -60,6 +66,12 @@ test.describe("Stripe Invoice Sharing Logic", () => {
expect(newDataParam).toBeTruthy();
expect(newDataParam).not.toBe("");
+ // Verify that the shared URL is not indexed by search engines (to prevent sensitive data from being indexed)
+ await expect(newPage.locator('meta[name="robots"]')).toHaveAttribute(
+ "content",
+ "noindex, nofollow",
+ );
+
// Verify stripe template UI elements are visible
const newPageGeneralInfoSection = newPage.getByTestId(
"general-information-section",
diff --git a/e2e/stripe-invoice-template/stripe-invoice-template.test.ts b/e2e/stripe-invoice-template/stripe-invoice-template.test.ts
index bba6530..db96da8 100644
--- a/e2e/stripe-invoice-template/stripe-invoice-template.test.ts
+++ b/e2e/stripe-invoice-template/stripe-invoice-template.test.ts
@@ -47,13 +47,13 @@ test.describe("Stripe Invoice Template", () => {
// Check other meta tags for Stripe template
await expect(page.locator('meta[property="og:title"]')).toHaveAttribute(
"content",
- "Stripe Template — Create Invoice | EasyInvoicePDF",
+ "Stripe Template - Create Invoice | EasyInvoicePDF",
);
await expect(
page.locator('meta[property="og:description"]'),
).toHaveAttribute(
"content",
- "Create and download professional invoices instantly with EasyInvoicePDF.com. Free and open-source. No signup required.",
+ "Create invoices online for free with our PDF invoice generator. Customize templates, download instantly, no signup required.",
);
await expect(page.locator('meta[property="og:site_name"]')).toHaveAttribute(
"content",
@@ -69,7 +69,7 @@ test.describe("Stripe Invoice Template", () => {
).toHaveAttribute("content", "630");
await expect(page.locator('meta[property="og:image:alt"]')).toHaveAttribute(
"content",
- "Stripe Invoice Template",
+ "Stripe Invoice Template - EasyInvoicePDF.com",
);
});
diff --git a/messages/en.json b/messages/en.json
index c655abf..062c2a9 100644
--- a/messages/en.json
+++ b/messages/en.json
@@ -80,31 +80,31 @@
},
"FAQ": {
"title": "Frequently Asked Questions",
- "description": "Answers about pricing, privacy, PDF download, using the app without an account, and sharing invoices with clients.",
+ "description": "Answers about our free PDF invoice generator: pricing, privacy, customizing templates, working without an account, and sharing invoices with clients.",
"items": {
"whatIs": {
"question": "What is EasyInvoicePDF?",
- "answer": "EasyInvoicePDF is a free, open-source invoice maker that helps you create professional PDF invoices fast. It includes a live PDF preview, customizable templates, and support for multiple languages and currencies."
+ "answer": "EasyInvoicePDF is a free online PDF invoice generator and open-source invoice maker. You build professional invoices in the browser with a live PDF preview, flexible tax and currency settings, and printed labels in multiple languages. It suits freelancers, consultants, and small businesses that want fast invoicing without installing paid software."
},
"isFree": {
- "question": "Is it really free?",
- "answer": "Yes, EasyInvoicePDF is completely free to use. The entire project is open-source and available on GitHub."
+ "question": "Is EasyInvoicePDF free to use?",
+ "answer": "Yes. Core invoicing, live preview, and PDF download are free with no paid subscription. The project is open source on GitHub, so you can inspect the code or self-host if you prefer."
},
"accountNeeded": {
- "question": "Do I need to create an account?",
- "answer": "No account or sign-up is required. You can start building invoices and use one-click PDF download immediately, with no registration."
+ "question": "Do I need an account to create or download a PDF invoice?",
+ "answer": "No sign-up or login is required. Open the editor, enter your details, and download a PDF in one click. Your draft stays in your browser until you leave the page or clear it."
},
"customization": {
- "question": "Can I customize the invoice template?",
- "answer": "Yes. You can customize company details, currency, language, taxes, and layout options in the editor. More template controls are added regularly."
+ "question": "Can I customize the PDF invoice template and fields?",
+ "answer": "Yes. You can set seller and buyer details, line items, currency, tax labels and amounts, language for dates and labels, and layout options that change how the PDF looks. New template controls are added over time."
},
"dataSecurity": {
- "question": "Is my data secure?",
- "answer": "Invoice data is processed client-side in your browser for PDF generation and preview. We do not store your invoice content on our servers."
+ "question": "Is my invoice data secure and private?",
+ "answer": "Preview and PDF generation run in your browser from the data you enter there. We do not store your invoice content on our servers for normal editing and download. Shareable links keep a compressed copy of the invoice inside the URL, not in a user account on our servers."
},
"sharing": {
- "question": "Can I share invoices with others?",
- "answer": "Yes. You can create a shareable link so clients can view the invoice and download the PDF. Only people with the link can open it."
+ "question": "How do I share an invoice with a client?",
+ "answer": "Use the share action in the editor to copy a link. The link carries your invoice data so recipients can open it in their browser, review the invoice, and download the PDF without signing up. Anyone with the full link can open it, so only send it to people you trust."
}
}
}
diff --git a/messages/es.json b/messages/es.json
index 9c23b23..607d842 100644
--- a/messages/es.json
+++ b/messages/es.json
@@ -80,7 +80,7 @@
},
"FAQ": {
"title": "Preguntas Frecuentes",
- "description": "Respuestas sobre precio (gratis), privacidad, descarga en PDF, uso sin cuenta y compartir facturas con clientes.",
+ "description": "Respuestas sobre uso gratuito, privacidad, descarga en PDF, uso sin cuenta y compartir facturas con clientes.",
"items": {
"whatIs": {
"question": "¿Qué es EasyInvoicePDF?",
diff --git a/messages/fr.json b/messages/fr.json
index 1c8f2d7..91d3e15 100644
--- a/messages/fr.json
+++ b/messages/fr.json
@@ -80,7 +80,7 @@
},
"FAQ": {
"title": "Questions Fréquemment Posées",
- "description": "Réponses sur le tarif (gratuit), la confidentialité, le téléchargement PDF, l'utilisation sans compte et le partage avec les clients.",
+ "description": "Réponses sur l'utilisation gratuite, la confidentialité, le téléchargement PDF, l'utilisation sans compte et le partage des factures avec les clients.",
"items": {
"whatIs": {
"question": "Qu'est-ce qu'EasyInvoicePDF ?",
diff --git a/messages/it.json b/messages/it.json
index 6321d44..8fc14ca 100644
--- a/messages/it.json
+++ b/messages/it.json
@@ -80,7 +80,7 @@
},
"FAQ": {
"title": "Domande Frequenti",
- "description": "Risposte su prezzo (gratis), privacy, download PDF, uso senza account e condivisione con i clienti.",
+ "description": "Risposte su uso gratuito, privacy, download PDF, utilizzo senza account e condivisione delle fatture con i clienti.",
"items": {
"whatIs": {
"question": "Cos'è EasyInvoicePDF?",
diff --git a/messages/pl.json b/messages/pl.json
index 20817e8..bc3c32e 100644
--- a/messages/pl.json
+++ b/messages/pl.json
@@ -80,7 +80,7 @@
},
"FAQ": {
"title": "Często Zadawane Pytania",
- "description": "Odpowiedzi o cenach (za darmo), prywatności, pobieraniu PDF, korzystaniu bez konta i udostępnianiu faktur klientom.",
+ "description": "Odpowiedzi o darmowym korzystaniu, prywatności, pobieraniu PDF, użytkowaniu bez konta i udostępnianiu faktur klientom.",
"items": {
"whatIs": {
"question": "Czym jest EasyInvoicePDF?",
diff --git a/messages/pt.json b/messages/pt.json
index 0f9b70a..195a305 100644
--- a/messages/pt.json
+++ b/messages/pt.json
@@ -10,7 +10,7 @@
"About": {
"tagline": "Gerador de faturas gratuito",
"hero": {
- "title": "Crie faturas profissionais em segundos",
+ "title": "Crie faturas PDF profissionais em segundos",
"description": "EasyInvoicePDF é uma <span>ferramenta gratuita</span> de código aberto que permite criar, personalizar e baixar faturas profissionais com <span>pré-visualização em tempo real</span>. Funciona completamente no seu navegador."
},
"features": {
@@ -80,7 +80,7 @@
},
"FAQ": {
"title": "Perguntas Frequentes",
- "description": "Respostas sobre preço (grátis), privacidade, download em PDF, uso sem conta e compartilhar faturas com clientes.",
+ "description": "Respostas sobre uso gratuito, privacidade, download em PDF, uso sem conta e compartilhar faturas com clientes.",
"items": {
"whatIs": {
"question": "O que é o EasyInvoicePDF?",
diff --git a/messages/ru.json b/messages/ru.json
index 647d08b..10c6fd4 100644
--- a/messages/ru.json
+++ b/messages/ru.json
@@ -10,7 +10,7 @@
"About": {
"tagline": "Бесплатный генератор счетов",
"hero": {
- "title": "Создавайте инвойсы за секунды",
+ "title": "Создавайте профессиональные PDF-счета за секунды",
"description": "EasyInvoicePDF — это <span>бесплатный</span> инструмент с открытым исходным кодом, который позволяет создавать, настраивать и скачивать инвойсы с <span>предпросмотром в реальном времени</span>. Работает полностью в вашем браузере."
},
"features": {
diff --git a/messages/uk.json b/messages/uk.json
index f7ea32f..5d640b9 100644
--- a/messages/uk.json
+++ b/messages/uk.json
@@ -10,7 +10,7 @@
"About": {
"tagline": "Безкоштовний генератор рахунків",
"hero": {
- "title": "Створюйте професійні рахунки за секунди",
+ "title": "Створюйте професійні PDF-рахунки за секунди",
"description": "EasyInvoicePDF — це <span>безкоштовний</span> інструмент з відкритим кодом, який дозволяє створювати, налаштовувати та завантажувати професійні рахунки з <span>попереднім переглядом у реальному часі</span>. Працює повністю в вашому браузері."
},
"features": {
diff --git a/src/app/(app)/components/invoice-page-header.tsx b/src/app/(app)/components/invoice-page-header.tsx
index 081c79e..909ec24 100644
--- a/src/app/(app)/components/invoice-page-header.tsx
+++ b/src/app/(app)/components/invoice-page-header.tsx
@@ -53,8 +53,14 @@ export function InvoicePageHeader({
isMobile: boolean;
isSharedInvoice: boolean;
}) {
+ const srOnlyHeading =
+ invoiceDataState.template === "stripe"
+ ? "Stripe Template - Create Invoice | EasyInvoicePDF"
+ : "Create Invoice - EasyInvoicePDF";
+
return (
<div data-testid="header">
+ <h1 className="sr-only">{srOnlyHeading}</h1>
<div className="flex w-full flex-row flex-wrap items-center justify-between lg:flex-nowrap">
<div className="relative bottom-2 mt-2 flex w-full flex-col justify-center sm:bottom-4 sm:mt-0">
<div className="flex items-center">
diff --git a/src/app/(app)/page.tsx b/src/app/(app)/page.tsx
index 0628a9c..5bf18de 100644
--- a/src/app/(app)/page.tsx
+++ b/src/app/(app)/page.tsx
@@ -1,9 +1,128 @@
import type { Metadata } from "next";
import { AppPageClient } from "./page.client";
-import { APP_URL, STATIC_ASSETS_URL } from "@/config";
+import { APP_URL, STATIC_ASSETS_URL, TWITTER_CREATOR } from "@/config";
import { fetchGithubStars } from "@/actions/fetch-github-stars";
import { CTAToastProvider } from "./contexts/cta-toast-context";
+const APP_PAGE_DESCRIPTION =
+ "Create invoices online for free with our PDF invoice generator. Customize templates, download instantly, no signup required.";
+
+const DEFAULT_TEMPLATE_META = {
+ title: "Free Invoice PDF Generator | EasyInvoicePDF",
+ canonical: `${APP_URL}/`, // we use root URL as canonical for SEO purposes
+ images: [
+ {
+ url: `${STATIC_ASSETS_URL}/easy-invoice-opengraph-image.png?v=1755773879597`,
+ type: "image/png",
+ width: 1200,
+ height: 630,
+ alt: "Default Invoice Template - EasyInvoicePDF.com",
+ },
+ ],
+} as const satisfies {
+ title: string;
+ canonical: string;
+ images: NonNullable<Metadata["openGraph"]>["images"];
+};
+
+const STRIPE_TEMPLATE_META = {
+ title: "Stripe Template - Create Invoice | EasyInvoicePDF",
+ canonical: `${APP_URL}/`, // we use root URL as canonical for SEO purposes
+ images: [
+ {
+ url: `${STATIC_ASSETS_URL}/stripe-og.png?v=1755773921680`,
+ width: 1200,
+ height: 630,
+ alt: "Stripe Invoice Template - EasyInvoicePDF.com",
+ },
+ ],
+} as const satisfies {
+ title: string;
+ canonical: string;
+ images: NonNullable<Metadata["openGraph"]>["images"];
+};
+
+/**
+ * Builds complete metadata object for invoice app templates.
+ *
+ * Constructs OpenGraph and Twitter metadata for template variants
+ * (default and Stripe), including title, description, canonical URL,
+ * and OG image specifications.
+ *
+ * @param meta - Template metadata object containing title, canonical URL, and OG images
+ * @returns Next.js Metadata object with OpenGraph and Twitter cards configured
+ */
+function buildTemplateMetadata(
+ meta: typeof DEFAULT_TEMPLATE_META | typeof STRIPE_TEMPLATE_META,
+): Metadata {
+ const { title, canonical, images } = meta;
+
+ return {
+ title,
+ description: APP_PAGE_DESCRIPTION,
+ alternates: {
+ canonical,
+ },
+ openGraph: {
+ title,
+ description: APP_PAGE_DESCRIPTION,
+ siteName: "EasyInvoicePDF.com | Free Invoice PDF Generator",
+ locale: "en_US",
+ type: "website",
+ url: canonical,
+ images: [...images],
+ },
+ twitter: {
+ card: "summary_large_image",
+ title,
+ description: APP_PAGE_DESCRIPTION,
+ creator: TWITTER_CREATOR,
+ images: [...images],
+ },
+ };
+}
+
+/**
+ * Resolves `robots` metadata for the main invoice app URL (`/`).
+ *
+ * Indexing is allowed only when `shouldIndex` is true (production deploy,
+ * no shareable `?data=` payload). Otherwise behavior depends on template:
+ * Stripe template URLs use `noindex` but `follow` so crawlers may discover links
+ * without indexing a duplicate variant; all other non-indexable cases use strict
+ * `noindex,nofollow` (including preview builds and share links).
+ *
+ * @param shouldIndex - Whether this response should be treated as the canonical indexable homepage.
+ * @param isStripeTemplate - Whether `template=stripe` is active (affects fallback when not indexable).
+ * @returns Next.js `Metadata.robots` object for this page.
+ */
+function resolveAppPageRobots(
+ shouldIndex: boolean,
+): NonNullable<Metadata["robots"]> {
+ if (shouldIndex) {
+ return {
+ index: true,
+ follow: true,
+ googleBot: {
+ index: true,
+ follow: true,
+ },
+ };
+ }
+
+ const strictNoIndexNoFollow = {
+ index: false,
+ follow: false,
+ googleBot: {
+ index: false,
+ follow: false,
+ },
+ } as const satisfies NonNullable<Metadata["robots"]>;
+
+ // if we have shareable data, we don't want to index the page
+ // or on non-production environments
+ return strictNoIndexNoFollow;
+}
+
// we generate metadata here, because we need access to searchParams (in layout we don't have it)
export async function generateMetadata({
searchParams,
@@ -18,108 +137,20 @@ export async function generateMetadata({
`https://${process.env.VERCEL_PROJECT_PRODUCTION_URL}` ===
"https://easyinvoicepdf.com";
- const defaultRobotsConfig = {
- index: false,
- follow: false,
- googleBot: {
- index: false,
- follow: false,
- },
- };
-
- // Only allow indexing on production and when there's no shareable data
+ /**
+ * Only allow indexing on production and when there's no shareable data
+ */
const shouldIndex = isProd && !hasShareableData;
+ const templateMetadata = buildTemplateMetadata(
+ isStripeTemplate ? STRIPE_TEMPLATE_META : DEFAULT_TEMPLATE_META,
+ );
+
+ const robots = resolveAppPageRobots(shouldIndex);
+
return {
- robots: shouldIndex
- ? {
- index: true,
- follow: true,
- googleBot: {
- index: true,
- follow: true,
- },
- }
- : defaultRobotsConfig,
- ...(isStripeTemplate
- ? {
- // stripe template
- alternates: {
- canonical: `${APP_URL}/?template=stripe`,
- },
- openGraph: {
- title: "Stripe Template — Create Invoice | EasyInvoicePDF",
- description:
- "Create and download professional invoices instantly with EasyInvoicePDF.com. Free and open-source. No signup required.",
- siteName: "EasyInvoicePDF.com | Free Invoice PDF Generator",
- locale: "en_US",
- type: "website",
- url: `${APP_URL}/?template=stripe`,
- images: [
- {
- url: `${STATIC_ASSETS_URL}/stripe-og.png?v=1755773921680`,
- width: 1200,
- height: 630,
- alt: "Stripe Invoice Template",
- },
- ],
- },
- twitter: {
- card: "summary_large_image",
- title: "Stripe Template — Create Invoice | EasyInvoicePDF",
- description:
- "Create and download professional invoices instantly with EasyInvoicePDF.com. Free and open-source. No signup required.",
- creator: "@vlad_sazon",
- images: [
- {
- url: `${STATIC_ASSETS_URL}/stripe-og.png?v=1755773921680`,
- width: 1200,
- height: 630,
- alt: "Stripe Invoice Template",
- },
- ],
- },
- }
- : {
- // default template
- alternates: {
- canonical: `${APP_URL}/?template=default`,
- },
- openGraph: {
- title: "Create Invoice — EasyInvoicePDF",
- description:
- "Create and download professional invoices instantly with EasyInvoicePDF.com. Free and open-source. No signup required.",
- siteName: "EasyInvoicePDF.com | Free Invoice PDF Generator",
- locale: "en_US",
- type: "website",
- url: `${APP_URL}/?template=default`,
- images: [
- {
- url: `${STATIC_ASSETS_URL}/easy-invoice-opengraph-image.png?v=1755773879597`,
- type: "image/png",
- width: 1200,
- height: 630,
- alt: "EasyInvoicePDF.com - Free Invoice PDF Generator",
- },
- ],
- },
- twitter: {
- card: "summary_large_image",
- title: "Create Invoice — EasyInvoicePDF",
- description:
- "Create and download professional invoices instantly with EasyInvoicePDF.com. Free and open-source. No signup required.",
- creator: "@vlad_sazon",
- images: [
- {
- url: `${STATIC_ASSETS_URL}/easy-invoice-opengraph-image.png?v=1755773879597`,
- type: "image/png",
- width: 1200,
- height: 630,
- alt: "EasyInvoicePDF.com - Free Invoice PDF Generator",
- },
- ],
- },
- }),
+ robots,
+ ...templateMetadata,
};
}
diff --git a/src/app/[locale]/about/__tests__/about-json-ld-graph.test.ts b/src/app/[locale]/about/__tests__/about-json-ld-graph.test.ts
index 24026ef..612f2ef 100644
--- a/src/app/[locale]/about/__tests__/about-json-ld-graph.test.ts
+++ b/src/app/[locale]/about/__tests__/about-json-ld-graph.test.ts
@@ -23,6 +23,7 @@ describe("buildAboutJsonLdGraph", () => {
url: "https://easyinvoicepdf.com/pl/about",
name: plMessages.Metadata.about.title,
description: plMessages.Metadata.about.description,
+ mainEntity: { "@id": "https://easyinvoicepdf.com/pl/about" },
});
expect(faqPage).toMatchObject({
@@ -55,6 +56,7 @@ describe("buildAboutJsonLdGraph", () => {
url: "https://easyinvoicepdf.com/en/about",
name: enMessages.Metadata.about.title,
description: enMessages.Metadata.about.description,
+ mainEntity: { "@id": "https://easyinvoicepdf.com/en/about" },
});
expect(faqPage).toMatchObject({
diff --git a/src/app/[locale]/about/about-faq-item-keys.ts b/src/app/[locale]/about/about-faq-item-keys.ts
new file mode 100644
index 0000000..f14fc23
--- /dev/null
+++ b/src/app/[locale]/about/about-faq-item-keys.ts
@@ -0,0 +1,12 @@
+/**
+ * FAQ entries shown on the about page and mirrored in FAQPage JSON-LD.
+ * Single source of truth to avoid schema/content drift.
+ */
+export const ABOUT_FAQ_ITEM_KEYS = [
+ "whatIs",
+ "isFree",
+ "accountNeeded",
+ "customization",
+ "dataSecurity",
+ "sharing",
+] as const;
diff --git a/src/app/[locale]/about/about-json-ld-graph.ts b/src/app/[locale]/about/about-json-ld-graph.ts
index 5f62119..3e9a524 100644
--- a/src/app/[locale]/about/about-json-ld-graph.ts
+++ b/src/app/[locale]/about/about-json-ld-graph.ts
@@ -3,16 +3,7 @@ import type { Locale } from "next-intl";
import type Messages from "../../../../messages/en.json";
import type { Graph } from "schema-dts";
-const FAQ_ITEM_KEYS = [
- "whatIs",
- "isFree",
- "accountNeeded",
- "customization",
- "dataSecurity",
- "sharing",
-] as const;
-
-type FaqItemKey = (typeof FAQ_ITEM_KEYS)[number];
+import { ABOUT_FAQ_ITEM_KEYS } from "./about-faq-item-keys";
/**
* Builds a JSON-LD graph for the about page with schema.org structured data.
@@ -31,7 +22,7 @@ export function buildAboutJsonLdGraph(
const pageUrl = `${baseUrl}/${locale}/about`;
const faqUrl = `${pageUrl}#faq`;
- const faqEntities = FAQ_ITEM_KEYS.map((key: FaqItemKey) => {
+ const faqEntities = ABOUT_FAQ_ITEM_KEYS.map((key) => {
const item = messages.FAQ.items[key];
if (!item) {
diff --git a/src/app/[locale]/about/layout.tsx b/src/app/[locale]/about/layout.tsx
index 80d11ac..3a0677b 100644
--- a/src/app/[locale]/about/layout.tsx
+++ b/src/app/[locale]/about/layout.tsx
@@ -4,9 +4,22 @@ import { routing } from "@/i18n/routing";
import { setRequestLocale } from "next-intl/server";
import type { Metadata } from "next";
import type EnMessages from "../../../../messages/en.json";
-import { APP_URL, STATIC_ASSETS_URL } from "@/config";
+import { APP_URL, STATIC_ASSETS_URL, TWITTER_CREATOR } from "@/config";
import { AboutJsonLd } from "./about-json-ld";
+const OPEN_GRAPH_LOCALE_BY_LOCALE = {
+ en: "en_US",
+ pl: "pl_PL",
+ de: "de_DE",
+ es: "es_ES",
+ pt: "pt_PT",
+ ru: "ru_RU",
+ uk: "uk_UA",
+ fr: "fr_FR",
+ it: "it_IT",
+ nl: "nl_NL",
+} as const satisfies Record<Locale, string>;
+
// Add metadata to make sure search engines can index the page
export async function generateMetadata({
params,
@@ -44,7 +57,8 @@ export async function generateMetadata({
title: messages.Metadata.about.title,
description: messages.Metadata.about.description,
siteName: messages.Metadata.about.siteName,
- locale: params.locale,
+ locale: OPEN_GRAPH_LOCALE_BY_LOCALE[params.locale],
+ alternateLocale: Object.values(OPEN_GRAPH_LOCALE_BY_LOCALE),
type: "website",
url: `${APP_URL}/${params.locale}/about`,
images: [
@@ -61,7 +75,7 @@ export async function generateMetadata({
card: "summary_large_image",
title: messages.Metadata.about.title,
description: messages.Metadata.about.description,
- creator: "@vlad_sazon",
+ creator: TWITTER_CREATOR,
images: [
{
url: `${STATIC_ASSETS_URL}/easy-invoice-opengraph-image.png?v=1755773879597`,
diff --git a/src/app/[locale]/about/page.tsx b/src/app/[locale]/about/page.tsx
index 1c1328b..562ac07 100644
--- a/src/app/[locale]/about/page.tsx
+++ b/src/app/[locale]/about/page.tsx
@@ -20,6 +20,7 @@ import { ChevronDown } from "lucide-react";
import { useTranslations, type Locale } from "next-intl";
import { setRequestLocale } from "next-intl/server";
import Link from "next/link";
+import { ABOUT_FAQ_ITEM_KEYS } from "@/app/[locale]/about/about-faq-item-keys";
import { GithubStarCtaMarketingPageBody } from "@/app/[locale]/about/components/github-star-cta-body";
import { Header, type HeaderProps } from "@/app/(components)/header";
@@ -183,7 +184,7 @@ function HeroSection() {
>
{/* Background decorative elements */}
<div className="absolute inset-0 overflow-hidden">
- <div className="absolute -right-40 -top-40 h-80 w-80 rounded-full bg-indigo-50/50 blur-3xl" />
+ <div className="pointer-events-none absolute -right-40 -top-40 h-80 w-80 rounded-full bg-indigo-50/50 blur-3xl" />
<div className="absolute bottom-0 left-1/4 h-64 w-64 rounded-full bg-emerald-50/40 blur-3xl" />
</div>
@@ -385,29 +386,6 @@ function FeaturesSection() {
function FaqSection() {
const t = useTranslations("FAQ");
- const FAQ_ITEMS = [
- {
- translationKey: "whatIs",
- },
- {
- translationKey: "isFree",
- },
- {
- translationKey: "accountNeeded",
- },
- {
- translationKey: "customization",
- },
- {
- translationKey: "dataSecurity",
- },
- {
- translationKey: "sharing",
- },
- ] as const satisfies {
- translationKey: string;
- }[];
-
return (
<section
id="faq"
@@ -426,19 +404,19 @@ function FaqSection() {
</div>
<div className="mx-auto mt-14 max-w-3xl">
<div className="space-y-2">
- {FAQ_ITEMS.map((item) => {
- const question = t(`items.${item.translationKey}.question`);
- const answer = t(`items.${item.translationKey}.answer`);
+ {ABOUT_FAQ_ITEM_KEYS.map((translationKey) => {
+ const question = t(`items.${translationKey}.question`);
+ const answer = t(`items.${translationKey}.answer`);
return (
<details
- key={item.translationKey}
+ key={translationKey}
className="group cursor-pointer border-b border-slate-200 bg-white transition-all duration-200 hover:border-slate-200"
>
<summary className="flex select-none items-center justify-between gap-2 py-3 text-left">
- <span className="text-base font-medium text-slate-900">
+ <h3 className="text-base font-medium text-slate-900">
{question}
- </span>
+ </h3>
<ChevronDown
className="ml-auto size-6 shrink-0 rounded-full p-1 text-slate-600 transition-all duration-200 hover:bg-gray-200 hover:text-slate-900 group-open:rotate-180"
aria-hidden="true"
diff --git a/src/app/changelog/[slug]/page.tsx b/src/app/changelog/[slug]/page.tsx
index ff795b4..02ed450 100644
--- a/src/app/changelog/[slug]/page.tsx
+++ b/src/app/changelog/[slug]/page.tsx
@@ -1,4 +1,9 @@
-import { APP_URL, STATIC_ASSETS_URL } from "@/config";
+import {
+ APP_URL,
+ PERSONAL_WEBSITE_URL,
+ STATIC_ASSETS_URL,
+ TWITTER_CREATOR,
+} from "@/config";
import {
formatChangelogDate,
getChangelogEntry,
@@ -47,7 +52,7 @@ export async function generateMetadata({
"Changelog | EasyInvoicePDF - Free & Open-Source Invoice Generator",
description:
"Stay up to date with the latest features, improvements, and bug fixes in EasyInvoicePDF.",
- authors: [{ name: "Vlad Sazonau", url: "https://x.com/vlad_sazon" }],
+ authors: [{ name: "Uladzislau Sazonau", url: PERSONAL_WEBSITE_URL }],
alternates: {
canonical: `https://easyinvoicepdf.com/changelog/${slug}`,
},
@@ -63,7 +68,7 @@ export async function generateMetadata({
title: "Changelog | Free Invoice PDF Generator",
description:
"Stay up to date with the latest features, improvements, and bug fixes in EasyInvoicePDF.",
- creator: "@vlad_sazon",
+ creator: TWITTER_CREATOR,
},
};
}
@@ -73,7 +78,7 @@ export async function generateMetadata({
return {
title: `${entry.metadata.title || `Update ${formattedDate}`}`,
description: entry.metadata.description,
- authors: [{ name: "Vlad Sazonau", url: "https://x.com/vlad_sazon" }],
+ authors: [{ name: "Uladzislau Sazonau", url: PERSONAL_WEBSITE_URL }],
alternates: {
canonical: `https://easyinvoicepdf.com/changelog/${slug}`,
},
diff --git a/src/app/changelog/content/easy-invoice-pdf-launch.mdx b/src/app/changelog/content/easy-invoice-pdf-launch.mdx
index d32793e..5b1f750 100644
--- a/src/app/changelog/content/easy-invoice-pdf-launch.mdx
+++ b/src/app/changelog/content/easy-invoice-pdf-launch.mdx
@@ -73,12 +73,15 @@ Automatically calculate European VAT rates and totals for your invoices. Complia
- Payment information and terms
- Invoice numbering and dating
+[View Release Notes for v1.0.0 on GitHub](https://github.com/VladSez/easy-invoice-pdf/releases/tag/EasyInvoicePDF-v1.0.0)
+
---
-**Ready to simplify your invoicing?**
+<div className="rounded-lg border-2 border-blue-200 bg-blue-50 p-6 dark:border-blue-900 dark:bg-blue-950">
+<h2>Ready to simplify your invoicing?</h2>
-Start creating professional invoices in seconds with our free, open-source tool at [easyinvoicepdf.com](https://easyinvoicepdf.com)
+Discover the free, open-source invoice generator trusted by thousands. Create professional invoices with QR codes, custom logos, and multi-currency support - instantly at [easyinvoicepdf.com](https://easyinvoicepdf.com?ref=changelog)
-**GitHub Repository**: [VladSez/easy-invoice-pdf](https://github.com/VladSez/easy-invoice-pdf)
+**GitHub**: [VladSez/easy-invoice-pdf](https://github.com/VladSez/easy-invoice-pdf)
-[View Release Notes for v1.0.0 on GitHub](https://github.com/VladSez/easy-invoice-pdf/releases/tag/EasyInvoicePDF-v1.0.0)
+</div>
diff --git a/src/app/changelog/content/qr-codes-and-improvements.mdx b/src/app/changelog/content/qr-codes-and-improvements.mdx
index c501f7e..de8c64f 100644
--- a/src/app/changelog/content/qr-codes-and-improvements.mdx
+++ b/src/app/changelog/content/qr-codes-and-improvements.mdx
@@ -36,8 +36,15 @@ export const metadata = {
- Delete invoice item flow not working correctly
- Item name field validation too strict (now optional for flexibility)
+[View Release Notes for v1.0.2 on GitHub](https://github.com/VladSez/easy-invoice-pdf/releases/tag/v1.0.2)
+
---
-**Full Changelog**: [`EasyInvoicePDF-1.0.1...v1.0.2`](https://github.com/VladSez/easy-invoice-pdf/compare/EasyInvoicePDF-1.0.1...v1.0.2)
+<div className="rounded-lg border-2 border-blue-200 bg-blue-50 p-6 dark:border-blue-900 dark:bg-blue-950">
+<h2>Ready to simplify your invoicing?</h2>
-[View Release Notes for v1.0.2 on GitHub](https://github.com/VladSez/easy-invoice-pdf/releases/tag/v1.0.2)
+Discover the free, open-source invoice generator trusted by thousands. Create professional invoices with QR codes, custom logos, and multi-currency support - instantly at [easyinvoicepdf.com](https://easyinvoicepdf.com?ref=changelog)
+
+**GitHub**: [VladSez/easy-invoice-pdf](https://github.com/VladSez/easy-invoice-pdf)
+
+</div>
diff --git a/src/app/changelog/content/seller-buyer-improvements.mdx b/src/app/changelog/content/seller-buyer-improvements.mdx
index 54c1dc2..d0baa28 100644
--- a/src/app/changelog/content/seller-buyer-improvements.mdx
+++ b/src/app/changelog/content/seller-buyer-improvements.mdx
@@ -37,8 +37,15 @@ export const metadata = {
- Buyer and seller dialogs now reset form values and pre-fill switch to their defaults when closed
- Buyer and seller names are trimmed of whitespace before saving; whitespace-padded duplicates are rejected
+[View Release Notes for v1.0.3 on GitHub](https://github.com/VladSez/easy-invoice-pdf/releases/tag/v1.0.3)
+
---
-**Full Changelog**: [`v1.0.2...v1.0.3`](https://github.com/VladSez/easy-invoice-pdf/compare/v1.0.2...v1.0.3)
+<div className="rounded-lg border-2 border-blue-200 bg-blue-50 p-6 dark:border-blue-900 dark:bg-blue-950">
+<h2>Ready to simplify your invoicing?</h2>
-[View Release Notes for v1.0.3 on GitHub](https://github.com/VladSez/easy-invoice-pdf/releases/tag/v1.0.3)
+Discover the free, open-source invoice generator trusted by thousands. Create professional invoices with QR codes, custom logos, and multi-currency support - instantly at [easyinvoicepdf.com](https://easyinvoicepdf.com?ref=changelog)
+
+**GitHub**: [VladSez/easy-invoice-pdf](https://github.com/VladSez/easy-invoice-pdf)
+
+</div>
diff --git a/src/app/changelog/content/stripe-pdf-template.mdx b/src/app/changelog/content/stripe-pdf-template.mdx
index b3680ff..0ac51dd 100644
--- a/src/app/changelog/content/stripe-pdf-template.mdx
+++ b/src/app/changelog/content/stripe-pdf-template.mdx
@@ -47,8 +47,15 @@ export const metadata = {
- feat: customizable tax/VAT label text + a lot of other improvements and bug fixes by [@VladSez](https://github.com/VladSez) in https://github.com/VladSez/easy-invoice-pdf/pull/163
+[View release notes for v1.0.1 on GitHub](https://github.com/VladSez/easy-invoice-pdf/releases/tag/EasyInvoicePDF-1.0.1)
+
---
-**Full Changelog**: [EasyInvoicePDF-v1.0.0...EasyInvoicePDF-1.0.1](https://github.com/VladSez/easy-invoice-pdf/compare/EasyInvoicePDF-v1.0.0...EasyInvoicePDF-1.0.1)
+<div className="rounded-lg border-2 border-blue-200 bg-blue-50 p-6 dark:border-blue-900 dark:bg-blue-950">
+<h2>Ready to simplify your invoicing?</h2>
-[View release notes for v1.0.1 on GitHub](https://github.com/VladSez/easy-invoice-pdf/releases/tag/EasyInvoicePDF-1.0.1)
+Discover the free, open-source invoice generator trusted by thousands. Create professional invoices with QR codes, custom logos, and multi-currency support - instantly at [easyinvoicepdf.com](https://easyinvoicepdf.com?ref=changelog)
+
+**GitHub**: [VladSez/easy-invoice-pdf](https://github.com/VladSez/easy-invoice-pdf)
+
+</div>
diff --git a/src/app/changelog/layout.tsx b/src/app/changelog/layout.tsx
index 3de9735..c368cac 100644
--- a/src/app/changelog/layout.tsx
+++ b/src/app/changelog/layout.tsx
@@ -1,6 +1,11 @@
import { Header } from "@/app/(components)/header";
import { Footer } from "@/app/(components)/footer";
-import { GITHUB_URL, STATIC_ASSETS_URL } from "@/config";
+import {
+ GITHUB_URL,
+ PERSONAL_WEBSITE_URL,
+ STATIC_ASSETS_URL,
+ TWITTER_CREATOR,
+} from "@/config";
import type { Metadata } from "next";
import Link from "next/link";
@@ -21,7 +26,7 @@ export const metadata: Metadata = {
"easyinvoicepdf",
"easy invoice pdf changelog",
],
- authors: [{ name: "Uladzislau Sazonau" }],
+ authors: [{ name: "Uladzislau Sazonau", url: PERSONAL_WEBSITE_URL }],
creator: "Uladzislau Sazonau",
publisher: "Uladzislau Sazonau",
alternates: {
@@ -61,7 +66,7 @@ export const metadata: Metadata = {
title: "Changelog | Free Invoice PDF Generator",
description:
"Stay up to date with the latest features, improvements, and bug fixes in EasyInvoicePDF.com",
- creator: "@vlad_sazon",
+ creator: TWITTER_CREATOR,
images: [
{
url: `${STATIC_ASSETS_URL}/easy-invoice-opengraph-image.png?v=1755773879597`,
diff --git a/src/app/founder/layout.tsx b/src/app/founder/layout.tsx
index 17cbcbc..e2d0a97 100644
--- a/src/app/founder/layout.tsx
+++ b/src/app/founder/layout.tsx
@@ -1,27 +1,40 @@
import { Footer } from "@/app/(components)/footer";
import { Header } from "@/app/(components)/header";
-import { GITHUB_URL, STATIC_ASSETS_URL } from "@/config";
+import {
+ GITHUB_URL,
+ PERSONAL_WEBSITE_URL,
+ STATIC_ASSETS_URL,
+ TWITTER_CREATOR,
+} from "@/config";
import type { Metadata } from "next";
import Link from "next/link";
export const dynamic = "force-static";
+const FOUNDER_PAGE_URL = `https://easyinvoicepdf.com/founder`;
+
+const FOUNDER_PAGE_TITLE = "Vlad Sazonau | Founder of EasyInvoicePDF";
+
+const FOUNDER_PAGE_DESCRIPTION =
+ "Meet Vlad Sazonau, founder of EasyInvoicePDF, the free open-source invoice PDF generator with live preview. Product engineer and design enthusiast with 8+ years building digital products.";
+
+const ogImageAlt = "Vlad Sazonau, founder of EasyInvoicePDF — product engineer";
+
export const metadata: Metadata = {
- title: "Vlad Sazonau | Founder of EasyInvoicePDF",
- description:
- "Meet Vlad Sazonau, the founder of EasyInvoicePDF. Pragmatic engineer and builder.",
+ title: FOUNDER_PAGE_TITLE,
+ description: FOUNDER_PAGE_DESCRIPTION,
keywords: [
"Vlad Sazonau",
- "EasyInvoicePDF founder",
+ "EasyInvoicePDF",
+ "founder",
"product engineer",
- "indie developer",
- "easyinvoicepdf",
+ "invoice PDF generator",
],
- authors: [{ name: "Uladzislau Sazonau" }],
+ authors: [{ name: "Uladzislau Sazonau", url: PERSONAL_WEBSITE_URL }],
creator: "Uladzislau Sazonau",
publisher: "Uladzislau Sazonau",
alternates: {
- canonical: "https://easyinvoicepdf.com/founder",
+ canonical: FOUNDER_PAGE_URL,
},
robots: {
index: true,
@@ -35,36 +48,34 @@ export const metadata: Metadata = {
},
},
openGraph: {
- title: "Vlad Sazonau | Founder of EasyInvoicePDF",
- description:
- "Meet Vlad Sazonau, the founder of EasyInvoicePDF. Pragmatic engineer and builder.",
+ title: FOUNDER_PAGE_TITLE,
+ description: FOUNDER_PAGE_DESCRIPTION,
siteName: "EasyInvoicePDF.com | Free Invoice PDF Generator",
type: "profile",
locale: "en_US",
- url: "https://easyinvoicepdf.com/founder",
+ url: FOUNDER_PAGE_URL,
images: [
{
url: `${STATIC_ASSETS_URL}/easy-invoice-opengraph-image.png?v=1755773879597`,
type: "image/png",
width: 1200,
height: 630,
- alt: "EasyInvoicePDF.com - Free Invoice PDF Generator",
+ alt: ogImageAlt,
},
],
},
twitter: {
card: "summary_large_image",
- title: "Vlad Sazonau | Founder of EasyInvoicePDF",
- description:
- "Meet Vlad Sazonau, the founder of EasyInvoicePDF. Pragmatic engineer and builder.",
- creator: "@vlad_sazon",
+ title: FOUNDER_PAGE_TITLE,
+ description: FOUNDER_PAGE_DESCRIPTION,
+ creator: TWITTER_CREATOR,
images: [
{
url: `${STATIC_ASSETS_URL}/easy-invoice-opengraph-image.png?v=1755773879597`,
type: "image/png",
width: 1200,
height: 630,
- alt: "EasyInvoicePDF.com - Free Invoice PDF Generator",
+ alt: ogImageAlt,
},
],
},
diff --git a/src/app/founder/page.tsx b/src/app/founder/page.tsx
index 0665c83..d00e687 100644
--- a/src/app/founder/page.tsx
+++ b/src/app/founder/page.tsx
@@ -34,6 +34,9 @@ export default function ContactPage() {
<p className="mt-3 text-center text-xl text-slate-600 md:text-2xl">
Product Engineer & Design Enthusiast
</p>
+ <p className="mt-2 text-center text-base text-slate-500 md:text-lg">
+ Founder of EasyInvoicePDF
+ </p>
</AnimatedDiv>
<AnimatedDiv
diff --git a/src/app/layout.tsx b/src/app/layout.tsx
index 15d2708..9ef185f 100644
--- a/src/app/layout.tsx
+++ b/src/app/layout.tsx
@@ -10,7 +10,7 @@ import Script from "next/script";
import { Toaster } from "sonner";
-import { STATIC_ASSETS_URL } from "@/config";
+import { PERSONAL_WEBSITE_URL, STATIC_ASSETS_URL } from "@/config";
import {
BREADCRUMB_JSONLD,
SITE_NAVIGATION_JSONLD,
@@ -47,7 +47,7 @@ export const metadata: Metadata = {
"invoice maker pdf",
"professional invoice generator",
],
- authors: [{ name: "Uladzislau Sazonau" }],
+ authors: [{ name: "Uladzislau Sazonau", url: PERSONAL_WEBSITE_URL }],
creator: "Uladzislau Sazonau",
publisher: "Uladzislau Sazonau",
icons: {
diff --git a/src/app/sitemap.ts b/src/app/sitemap.ts
index ea24b44..2626197 100644
--- a/src/app/sitemap.ts
+++ b/src/app/sitemap.ts
@@ -11,45 +11,60 @@ export default async function sitemap(): Promise<MetadataRoute.Sitemap> {
const sitemapEntries: MetadataRoute.Sitemap = [
// Main app page (non-shared version)
{
- url: `${APP_URL}?template=default`,
+ url: `${APP_URL}/`,
lastModified,
changeFrequency: "daily",
priority: 1,
},
// About pages in all languages
- ...SUPPORTED_LANGUAGES.map((locale) => ({
- url: `${APP_URL}/${locale}/about`,
+ {
+ url: `${APP_URL}/en/about`,
lastModified,
- changeFrequency: "daily" as const,
+ changeFrequency: "weekly" as const,
priority: 1,
- })),
+ alternates: {
+ languages: {
+ "x-default": `${APP_URL}/en/about`,
+ ...Object.fromEntries(
+ SUPPORTED_LANGUAGES.map((lang) => [
+ lang,
+ `${APP_URL}/${lang}/about`,
+ ]),
+ ),
+ },
+ },
+ },
// Changelog page
{
url: `${APP_URL}/changelog`,
lastModified,
- changeFrequency: "daily",
- priority: 1,
+ changeFrequency: "weekly",
+ priority: 0.7,
},
// Changelog entries
- ...changelogEntries.map((entry) => ({
- url: `${APP_URL}/changelog/${entry.slug}`,
- lastModified,
- changeFrequency: "daily" as const,
- priority: 1,
- })),
+ ...changelogEntries.map((entry) => {
+ const lastModified = new Date(entry.metadata.date);
+
+ return {
+ url: `${APP_URL}/changelog/${entry.slug}`,
+ lastModified,
+ changeFrequency: "weekly" as const,
+ priority: 0.7,
+ };
+ }),
// Terms of Service page
{
url: `${APP_URL}/tos`,
lastModified,
changeFrequency: "monthly",
- priority: 1,
+ priority: 0.5,
},
// Founder page
{
url: `${APP_URL}/founder`,
lastModified,
changeFrequency: "monthly",
- priority: 1,
+ priority: 0.5,
},
];
diff --git a/src/app/tos/layout.tsx b/src/app/tos/layout.tsx
index 9dee574..9a251ff 100644
--- a/src/app/tos/layout.tsx
+++ b/src/app/tos/layout.tsx
@@ -1,6 +1,11 @@
import { Footer } from "@/app/(components)/footer";
import { Header } from "@/app/(components)/header";
-import { GITHUB_URL, STATIC_ASSETS_URL } from "@/config";
+import {
+ GITHUB_URL,
+ PERSONAL_WEBSITE_URL,
+ STATIC_ASSETS_URL,
+ TWITTER_CREATOR,
+} from "@/config";
import type { Metadata } from "next";
import Link from "next/link";
@@ -15,7 +20,7 @@ export const metadata: Metadata = {
"invoice generator",
"legal",
],
- authors: [{ name: "Uladzislau Sazonau" }],
+ authors: [{ name: "Uladzislau Sazonau", url: PERSONAL_WEBSITE_URL }],
creator: "Uladzislau Sazonau",
publisher: "Uladzislau Sazonau",
alternates: {
@@ -55,7 +60,7 @@ export const metadata: Metadata = {
title: "Terms of Service | EasyInvoicePDF",
description:
"Terms of Service for EasyInvoicePDF.com. Browser-based invoice PDF tool.",
- creator: "@vlad_sazon",
+ creator: TWITTER_CREATOR,
images: [
{
url: `${STATIC_ASSETS_URL}/easy-invoice-opengraph-image.png?v=1755773879597`,
diff --git a/src/config.ts b/src/config.ts
index 4ab54ac..5a2712c 100644
--- a/src/config.ts
+++ b/src/config.ts
@@ -35,6 +35,9 @@ export const LINKEDIN_URL =
"https://www.linkedin.com/in/vlad-sazonau-22a9a9126/";
export const TWITTER_URL = "https://x.com/vladsazonau";
+export const TWITTER_CREATOR = "@vlad_sazonau";
+
+export const PERSONAL_WEBSITE_URL = "https://vladsazon.com";
export const BUG_REPORT_URL =
"https://pdfinvoicegenerator.userjot.com/board/bugs";