Architecting Accunest: Building a Production-Grade GST Invoicing & Inventory Engine with Next.js 16, Zod, and Client-Side jsPDF

Accounting tools built for Western tax frameworks frequently fail when applied to Indian fiscal compliance. In India, invoicing is rigorously structured: transactions require exact tax bifurcation (CGST + SGST vs. IGST), HSN/SAC code mapping, and strict formatting rules for PAN numbers, GSTINs, and bank identifiers.

During the engineering of Accunest, our objective was to construct an enterprise-grade invoicing, inventory management, and financial accounting suite tailored for Indian SMBs that guarantees zero calculation errors while minimizing cloud hosting costs.

1. Decoupling Tax Calculation with Client-Side Zod Compilers

Traditional software sends a network request every time an accountant changes a line item quantity or discount percentage. This introduces lag and breaks user concentration.

Accunest implements decoupled client-side tax compilation. As items are added or modified, a Zod schema validates the payload in real-time, computing sub-totals, tax splits, and round-offs in under 5ms:

// Strict Indian Invoicing Zod Validator
export const InvoiceItemSchema = z.object({
  description: z.string().min(1, "Item description required"),
  hsnCode: z.string().regex(/^\d{4,8}$/, "HSN code must be 4 to 8 digits"),
  quantity: z.number().min(1, "Quantity must be at least 1"),
  unitPrice: z.number().min(0, "Price cannot be negative"),
  gstRate: z.number().default(18), // 0, 5, 12, 18, 28%
  isInterstate: z.boolean(),
}).transform((item) => {
  const taxableAmount = item.quantity * item.unitPrice;
  const taxAmount = (taxableAmount * item.gstRate) / 100;
  return {
    ...item,
    taxableAmount,
    cgst: item.isInterstate ? 0 : taxAmount / 2,
    sgst: item.isInterstate ? 0 : taxAmount / 2,
    igst: item.isInterstate ? taxAmount : 0,
    total: taxableAmount + taxAmount,
  };
});
      

2. Real-Time Fiscal Validations

Regulatory rejections occur when businesses submit invalid PANs or GST numbers. Accunest enforces instant regex pattern checking:

• PAN Validation: Strictly enforces ^[A-Z]{5}[0-9]{4}[A-Z]{1}$ before form submission is enabled.
• Unified Phone Checks: Enforces standard Indian 10-digit formats while rejecting invalid prefixes.
• Bank Registry Mapping: Dynamic selection list mapping all primary Indian banking institutions, standardizing IFSC formatting.

3. Sub-Second Client-Side PDF Compilation via jsPDF

Generating PDFs on server clusters using headless Chrome (Puppeteer) is slow and memory-intensive, requiring 200MB+ RAM per render. Accunest builds invoice documents directly in the client's browser memory using jsPDF and jspdf-autotable. The resulting vector PDF downloads in under 300ms, completely eliminating server PDF compute costs.

4. Quick-Add Modals & Cache Invalidation

Invoicing workflows are frequently interrupted when an accountant encounters an unlisted customer or new inventory item. With TanStack Query v5 cache invalidation, users trigger the Quick-Add modal, add the missing customer, and watch the dropdown update instantly without losing previously typed line items.

Explore how our team builds robust enterprise software on our Custom Software Development Services page.