How shailifadadu/invoease works
InvoEase is a web invoicing product for businesses and freelancers. Users sign in by email, complete onboarding, then create and manage invoices; dashboard views summarize revenue and invoice status. Server actions validate and persist invoice changes, with invoice emails and a public invoice endpoint supporting sharing. The README also documents print-ready PDF export and multi-currency support. Relationships reflect the sampled code, SOURCE INDEX references, and README; unsampled capabilities are represented without guessing their internal wiring.
Main entry points: actions.ts Server actions · auth.ts Magic-link auth · db.ts Prisma data access · page.tsx Dashboard
Components 22
Identity & onboarding
- Email login
app/login/page.tsx - Magic-link auth
app/utils/auth.ts - Auth endpoint
app/api/auth/[...nextauth]/route.ts - Profile onboarding
app/onboarding/page.tsx
Invoice management
- Server actions
app/actions.ts - Invoice creation
app/components/CreateInvoice.tsx - Invoice editing
app/components/EditInvoice.tsx - Invoice routes
app/dashboard/invoices/[invoiceId]/page.tsx - Invoice listing
app/components/InvoiceList.tsx - Invoice document API
app/api/invoice/[invoiceId]/route.ts - Invoice email API
app/api/email/[invoiceId]/route.ts - Print-ready PDF export
app/api/invoice/[invoiceId]/route.ts
Dashboard & insights
- Dashboard
app/dashboard/page.tsx - Revenue metrics
app/components/DashboardBlocks.tsx - Invoice insights
app/components/InvoiceGraph.tsx
Data & delivery
- Prisma data access
app/utils/db.ts - PostgreSQL
- Mailtrap
- Currency formatting
app/utils/formatCurrency.ts - Form schemas
app/utils/zodSchemas.ts - Session guard
app/utils/hooks.ts
Other components
- Business user
Connections 29
- Business user → Email login: starts sign-in
- Email login → Magic-link auth: requests sign-in
app/login/page.tsx - Auth endpoint → Magic-link auth: dispatches handlers
app/api/auth/[...nextauth]/route.ts - Magic-link auth → Prisma data access: uses adapter
app/utils/auth.ts - Magic-link auth → Mailtrap: sends magic link
- Business user → Profile onboarding: enters profile
- Profile onboarding → Server actions: submits profile
app/onboarding/page.tsx - Server actions → Session guard: requires session
app/actions.ts - Session guard → Magic-link auth: checks session
app/utils/hooks.ts - Server actions → Form schemas: validates input
app/actions.ts - Business user → Invoice creation: creates invoice
- Invoice creation → Server actions: submits invoice
app/components/CreateInvoice.tsx - Business user → Invoice routes: manages invoices
- Invoice routes → Invoice editing: renders editor
app/dashboard/invoices/[invoiceId]/page.tsx - Invoice editing → Server actions: submits changes
app/components/EditInvoice.tsx - Server actions → Prisma data access: writes invoices
app/actions.ts - Prisma data access → PostgreSQL: reads and writes
- Server actions → Mailtrap: sends invoice email
app/actions.ts - Server actions → Currency formatting: formats totals
app/actions.ts - Business user → Dashboard: views activity
- Dashboard → Revenue metrics: renders metrics
app/dashboard/page.tsx - Dashboard → Invoice insights: renders charts
app/dashboard/page.tsx - Dashboard → Invoice listing: links invoices
- Invoice document API → Prisma data access: reads invoice
app/api/invoice/[invoiceId]/route.ts - Invoice document API → Currency formatting: formats amount
app/api/invoice/[invoiceId]/route.ts - Invoice document API → Print-ready PDF export: provides document
app/api/invoice/[invoiceId]/route.ts - Invoice email API → Prisma data access: reads invoice
app/api/email/[invoiceId]/route.ts - Invoice email API → Session guard: checks session
app/api/email/[invoiceId]/route.ts - Invoice email API → Mailtrap: sends email
app/api/email/[invoiceId]/route.ts