Insight Board

A modern, scalable SaaS application built with Next.js (TypeScript). It provides AI-powered dashboards by integrating data from services like Stripe, Shopify, and Google Analytics. Designed with TDD, component-based architecture, and full test coverage using Jest and React Testing Library.

---

Features

• Next.js (TypeScript) – Fast, SEO-optimized React framework
• NextAuth.js – Secure authentication and provider logins
• API Integrations – Connect Stripe, Shopify, GA4 (OAuth-based)
• Smart Dashboards – Auto-generated KPIs with customizable layouts
• TDD Workflow – Unit and integration testing baked in from day 1
• TailwindCSS – Utility-first styling for fast UI iteration
• CI/CD Ready – Deploy on Vercel with preview URLs and GitHub Actions

Tech Stack

Area	Stack
Framework	Next.js (TypeScript)
Styling	Tailwind CSS
Auth	NextAuth.js
Testing	Jest, React Testing Library
Deployment	Vercel

Getting Started

1. Clone & Install

git clone https://github.com/itsferdiardiansa/Insight-Board.git
cd insight-board
pnpm install

2. Create .env(?.local|)

DATABASE_URL=postgres://...
NEXTAUTH_URL=http://localhost:3000
NEXTAUTH_SECRET=your-secret
STRIPE_CLIENT_ID=...
STRIPE_SECRET=...
GOOGLE_CLIENT_ID=...
GOOGLE_CLIENT_SECRET=...
SHOPIFY_API_KEY=...

3. Start Dev Server

pnpm run dev

then visit http://localhost:3000

Testing

Run All Tests

pnpm test

Watch Mode

pnpm run test:watch

Coverage Report

pnpm run test:coverage

Example test file:

// button/__tests__/index.tsx
import { render, screen } from '@testing-library/react';
import Button from '..';

test('renders button with text', () => {
  render(<Button label="Click me" />);
  expect(screen.getByText('Click me')).toBeInTheDocument();
});

Deployment

Recommended: Vercel

• Push code to GitHub
• Import the repo into Vercel
• Set environment variables
• Vercel auto-detects and deploys your Next.js app

Roadmap

• TDD setup with Jest + RTL
• OAuth integration with Stripe, GA, Shopify
• Drag-and-drop dashboard editor
• Multi-tenant support
• Admin portal for usage analytics