Add invoice template system with custom branding

[davedumto]

Feature: Add invoice template system with custom branding

User Story

As a freelancer, I want to customize invoice appearance (logo, colors, footer text) so my brand is consistent across all client communications.

Current Behavior

• All invoices use default LancePay template
• No customization options
• Generic "LancePay" branding

Proposed Feature

Add invoice template editor:

API Endpoints:

GET  /api/routes-d/branding/templates       // List templates
POST /api/routes-d/branding/templates       // Create template
PUT  /api/routes-d/branding/templates/[id]  // Update template
GET  /api/routes-d/branding/templates/[id]  // Get template

Template Schema:

interface InvoiceTemplate {
  id: string;
  userId: string;
  name: string;
  isDefault: boolean;
  
  // Branding
  logoUrl?: string;
  primaryColor: string;   // hex color
  accentColor: string;
  
  // Customization
  showLogo: boolean;
  showFooter: boolean;
  footerText?: string;    // "Thank you for your business!"
  
  // Layout
  layout: 'modern' | 'classic' | 'minimal';
  
  createdAt: Date;
  updatedAt: Date;
}

Invoice Preview:

┌─────────────────────────────────────┐
│ [USER LOGO]          Invoice #12345 │
│                                     │
│ Bill To: client@company.com         │
│ Amount: $500.00                     │
│ Due: Jan 30, 2026                   │
│                                     │
│ [Pay with USDC Button]              │
│                                     │
│ Custom footer: "Thanks for your     │
│ business! Net 30 terms apply."      │
└─────────────────────────────────────┘

Acceptance Criteria

• Users can upload custom logo (max 2MB)
• Hex color picker for primary/accent colors
• Live preview of invoice template
• Set default template (applies to all new invoices)
• Max 5 templates per user
• Templates apply to email notifications too
• Export invoice as branded PDF

Files to Create

• app/api/routes-d/branding/templates/route.ts
• app/api/routes-d/branding/templates/[id]/route.ts
• components/settings/TemplateEditor.tsx
• lib/invoice-renderer.tsx (PDF generation)

Database Migration

model InvoiceTemplate {
  id           String   @id @default(cuid())
  userId       String
  name         String
  isDefault    Boolean  @default(false)
  logoUrl      String?
  primaryColor String   @default("#000000")
  accentColor  String   @default("#059669")
  showLogo     Boolean  @default(true)
  showFooter   Boolean  @default(true)
  footerText   String?
  layout       String   @default("modern")
  createdAt    DateTime @default(now())
  updatedAt    DateTime @updatedAt
  
  user User @relation(fields: [userId], references: [id], onDelete: Cascade)
  
  @@index([userId, isDefault])
}

Priority

Medium - Nice-to-have for brand-conscious freelancers

[drips-wave]

This issue has been added to the Stellar Wave Program and is worth 200 Points.

🧑‍💻 Interested in contributing? Apply to work on this issue on Drips Wave, earn points, and receive rewards.

Warning

Only applications submitted via the apply link above will be considered. Please do not apply by commenting on the issue or opening a PR directly.

🤠 Repo maintainers: You can manage this issue's Points and Complexity on your Maintainer Dashboard here. Please keep an eye on applications and respond quickly 💙

ℹ️ Learn more about Drips Wave

[firstJOASH]

@firstJOASH has applied to work on this issue as part of the Stellar Wave Program's 2nd wave.

i can solve this issue please assign me

ℹ️ Repo Maintainers: To accept this application, review their application or assign @firstJOASH to this issue.

[ALIPHATICHYD]

@ALIPHATICHYD has applied to work on this issue as part of the Stellar Wave Program's 2nd wave.

Hi Maintainer, I'd love to work on this issue

ℹ️ Repo Maintainers: To accept this application, review their application or assign @ALIPHATICHYD to this issue.

[Jayrodri088]

@Jayrodri088 has applied to work on this issue as part of the Stellar Wave Program's 2nd wave.

As a Full-Stack Developer with 4+ years working on freelancer platforms and invoice automation systems, I have built branded template editors with PDF export for 5+ SaaS products including live preview and email integration. I will implement the complete invoice template system including all 4 API endpoints (GET/POST/PUT/[id]), Prisma InvoiceTemplate model migration, TemplateEditor component with logo upload (2MB limit), hex color pickers, live invoice preview, 5-template user limit enforcement, default template selection, and branded PDF generation via invoice-renderer ensuring templates apply to both UI and email notifications, meeting all acceptance criteria within 10-12 hours.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Jayrodri088 to this issue.

[drips-wave]

Congratulations, @Jayrodri088! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on February 26, 2026.

🧑‍💻 @Jayrodri088: Please resolve the issue such that the repo's maintainers have enough time to review your contribution before the due date. You'll earn Points for completing the issue on-time, which will make you eligible for a share of the Stellar Wave Program's reward pool.

Warning

When opening a PR, please link it to this issue to ensure it gets tracked accurately. Points are issued when this issue is marked as completed by the maintainer.

🤠 Repo maintainers: Please keep an eye on the contributor's progress and review their work before the due date. You can manage this issue, including adjusting its complexity and points, here.

🌊 Happy Wave 🌊

[macan88]

👋 Hi! I've submitted a fix for this issue: #274

If my PR gets merged, please send the bounty reward ($500 USDC) to:

0xd95f60C1d395f15fba3C8d19d7BA4b8e5D2450bb

Thank you! 🙏

[drips-wave]

This issue has been marked as completed by a Drips Wave moderator for @Jayrodri088 as part of the Stellar Wave Program's 2nd Wave 🥳

Moderator's reason: Substantial work has been submitted in PR:#262, but it was not reviewed/merged within the Wave.

😎 @Jayrodri088: You earned 200 Points for completing this issue! After the current Wave ends, you'll be eligible for a percentage of the Wave's reward pool based on the percentage of total points you've earned. Learn more here.

🧑‍💻 Repo maintainers: How'd the contributor do? Leave a review to share your experience working with them.

ℹ️ Note: This issue was marked complete via moderation. Points were issued even though the GitHub issue remains open.

[yuliuyi717-ux]

Claiming this one. I’ll implement an invoice template system with custom branding fields (logo, colors, typography), add sensible defaults and validation, and wire it into invoice rendering so templates can be selected per account/invoice. I’ll include tests and docs for the new flow. I’ll post progress here and follow up with a PR once the first pass is ready.
/apply