https://github.com/itsferdiardiansa/insight-board
InsightBoard is a modern, AI-powered SaaS dashboard platform that helps businesses turn raw data into actionable insights.
https://github.com/itsferdiardiansa/insight-board
apple-auth google-auth jest nextjs react-testing-library supabase tailwindcss typescript
Last synced: 4 months ago
JSON representation
InsightBoard is a modern, AI-powered SaaS dashboard platform that helps businesses turn raw data into actionable insights.
- Host: GitHub
- URL: https://github.com/itsferdiardiansa/insight-board
- Owner: itsferdiardiansa
- License: mit
- Created: 2025-05-02T08:21:16.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-09-29T13:18:48.000Z (9 months ago)
- Last Synced: 2025-09-29T15:24:01.594Z (9 months ago)
- Topics: apple-auth, google-auth, jest, nextjs, react-testing-library, supabase, tailwindcss, typescript
- Language: TypeScript
- Homepage: https://insight-board.ferdiardiansa.com
- Size: 82.8 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Insight Board
[](https://nextjs.org/)
[](https://reactjs.org/)
[](https://tanstack.com/query)
[](https://jestjs.io/)
[](https://github.com/itsferdiardiansa/Insight-Board/actions/workflows/test.yaml)
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
```bash
git clone https://github.com/itsferdiardiansa/Insight-Board.git
cd insight-board
pnpm install
```
#### 2. Create .env(?.local|)
```bash
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
```bash
pnpm run dev
```
then visit `http://localhost:3000`
## Testing
#### Run All Tests
```bash
pnpm test
```
#### Watch Mode
```bash
pnpm run test:watch
```
#### Coverage Report
```bash
pnpm run test:coverage
```
#### Example test file:
```ts
// button/__tests__/index.tsx
import { render, screen } from '@testing-library/react';
import Button from '..';
test('renders button with text', () => {
render();
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