╭──────────╮
  │ ┌──┐     │
  │ │──│     │
  │ └──┘     │
  ╰──────────╯

impeccabyte

Banking · Payments · Payroll — One Dashboard

---

Impeccabyte Dashboard is a comprehensive financial operations platform that enables business owners to manage banking services, payment processing, and payroll & benefits administration from a single, unified interface.

Features

• Passwordless Authentication — Magic link sign-in powered by Supabase Auth
• Business Application Flow — Multi-step onboarding with document uploads and real-time draft saving
• Entity Management — Multi-business selector for owners managing multiple entities
• Row-Level Security — Granular data access policies at the database layer
• Responsive Design — Split-panel layout with brand panel + form panel pattern

Tech Stack

Layer	Technology
Framework	Next.js 16 (App Router, RSC, Server Actions, Turbopack)
UI	React 19, Tailwind CSS v4, shadcn/ui (new-york)
Icons	Lucide React
Auth & Database	Supabase (Auth, Postgres, Storage, RLS)
Language	TypeScript 5
Fonts	Inter (body), Nunito (display)

Brand Palette

Token	Hex	Usage
brand-dark	#4F6050	Hover states, emphasis
brand	#5C6B5E	Primary brand color
brand-mid	#6E806F	Gradients
brand-light	#7D8E7F	Secondary elements
brand-sage	#8B9A7B	Gradient endpoints
gold	#C4A882	Accents, pending states
surface	#FAFAF7	Page background

Getting Started

Prerequisites

• Node.js 20+
• A Supabase project with Auth and Storage enabled

Installation

git clone <repo-url> && cd dashboard
npm install

Environment Variables

Create a .env.local file:

NEXT_PUBLIC_SUPABASE_URL=https://your-project.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-key

Development

npm run dev

Open http://localhost:3000 to view the app.

Project Structure

app/
├── page.tsx                    # Login (unauth) / Business Selector (auth)
├── register/                   # Account registration
├── magic/                      # Magic link confirmation
├── auth/
│   ├── actions.ts              # Sign-in / sign-out server actions
│   └── callback/route.ts       # OAuth callback handler
├── apply/
│   ├── page.tsx                # Multi-step application (Steps 1-3)
│   ├── actions.ts              # Application server actions
│   ├── submitted/              # Post-submission confirmation
│   └── denied/                 # Denial notice
├── components/
│   ├── BusinessSelector.tsx    # Entity selection grid
│   ├── LoginForm.tsx           # Magic link form
│   ├── RegisterForm.tsx        # Registration form
│   ├── LogoIcon.tsx            # Brand icon component
│   ├── MeshPattern.tsx         # Decorative pattern
│   └── apply/
│       ├── StepOne.tsx         # Business details
│       ├── StepTwo.tsx         # Controller details + documents
│       ├── StepThree.tsx       # Review & submit
│       ├── ApplicationBrandPanel.tsx
│       └── ProgressBar.tsx
lib/
├── supabase/
│   ├── client.ts               # Browser Supabase client
│   ├── server.ts               # Server Supabase client
│   └── proxy.ts                # Proxy (middleware) session handler
├── types/
│   └── application.ts          # Application TypeScript types
└── utils.ts                    # Utility helpers

Roadmap

Banking — Column NA Integration

• Register Column API credentials and configure environment variables
• Create businesses_bank_accounts table with RLS policies
• Implement bank account creation flow (entity to account provisioning)
• Build account detail view (balance, account/routing numbers)
• Integrate ACH transfer initiation (send/receive)
• Integrate domestic wire transfer initiation
• Build transaction ledger with real-time webhook updates
• Implement book transfers between Impeccabyte-held accounts
• Add statement generation and download
• Set up Column webhooks for transaction status updates
• Add counterparty management for recurring transfers

Payment Processing — Maverick Payments Integration

• Register Maverick API credentials and configure environment variables
• Create businesses_merchant_accounts table with RLS policies
• Implement merchant account enrollment and underwriting flow
• Build payment gateway configuration (API keys, webhook URLs)
• Integrate virtual terminal for manual card-present/card-not-present transactions
• Build transaction history view with search and filtering
• Implement settlement and funding schedule display
• Add chargeback and dispute management workflow
• Integrate recurring billing / subscription management
• Build reporting dashboard (volume, approvals, declines, chargebacks)
• Add PCI-compliant tokenized card vault

Payroll & Benefits — Check HQ Integration

• Register Check API credentials and configure environment variables
• Create businesses_payroll and businesses_employees tables with RLS policies
• Implement company onboarding (EIN, tax setup, pay schedule)
• Build employee onboarding flow (W-4, direct deposit, state taxes)
• Integrate payroll run creation and preview
• Implement payroll approval and processing workflow
• Build pay stub generation and employee self-service portal
• Add federal and state tax filing status tracking
• Integrate benefits enrollment (health, dental, vision, 401k)
• Build contractor payment flow (1099 management)
• Add year-end tax document generation (W-2, 1099)
• Implement PTO tracking and accrual management

Platform — General

• Build authenticated dashboard home with account summaries
• Implement role-based access control (owner, admin, viewer)
• Add activity log / audit trail
• Build notification center (in-app + email)
• Implement multi-factor authentication
• Add dark mode support
• Build admin panel for internal application review
• Add comprehensive error handling and monitoring
• Write end-to-end test suite
• Set up CI/CD pipeline

License

Proprietary — Impeccabyte, LLC. All rights reserved.