SMB Utils

A unified platform of purpose-built tools designed to help small and medium businesses navigate operational complexity.

Overview

SMB Utils targets the "spreadsheet gap" — businesses too large for manual processes but too small for complex enterprise solutions. The platform bundles focused utilities under a single subscription to provide immediate value without feature bloat.

Core Utilities

• Cash Runway Tracking: Monitor financial health and runway.
• Tax Nexus Monitoring: Keep track of tax obligations across jurisdictions.
• Vendor Compliance: Manage vendor requirements and status.
• Supplier Diversity Documentation: Simplify diversity certification and documentation.

Tech Stack

This project is built with the T3 Stack and modern web technologies:

• Framework: Next.js 15 (App Router)
• Language: TypeScript
• Styling: Tailwind CSS 4 & Motion
• Database: MySQL (via Docker) with Prisma ORM
• API: tRPC
• Authentication: Better Auth
• Email: React Email
• Tooling: Biome (Linting/Formatting), pnpm

Getting Started

Prerequisites

• Node.js (Latest LTS recommended)
• pnpm
• Docker (for local database)

Installation

1. Clone the repository

   git clone <repository-url>
   cd smbutils

2. Install dependencies

   pnpm install

3. Environment Setup Copy the example environment file and update variables:

   cp .env.example .env

4. Start the Database Start the local MySQL instance:

   ./start-database.sh

5. Initialize Database Push the schema to your local database:

   pnpm db:push

6. Start Development Server

   pnpm dev

   The app should now be running at http://localhost:3000.

Scripts

• pnpm dev - Start the development server
• pnpm build - Build the application for production
• pnpm start - Start the production server
• pnpm db:push - Push Prisma schema changes to the database
• pnpm db:studio - Open Prisma Studio to view/edit data
• pnpm email - Start the React Email preview server
• pnpm check - Run Biome linter/formatter check

Project Structure

• src/app - Next.js App Router pages and layouts
• src/server - Backend logic (tRPC routers, DB client, Auth)
• src/components - React components (UI library, shared components)
• src/emails - React Email templates
• prisma/schema.prisma - Database schema definition

License

Proprietary. All rights reserved.