🚀 FounderFlow

Live Demo API Status Tech Stack

A production-grade SaaS platform for startup financial management and investor relations.

Table of Contents

Overview

Architecture

High-Level System Architecture

 +-----------------------+
 | Client Browser |
 +-----------+-----------+
 |
 | HTTPS
 v
 +-----------+-----------+
 | Vercel CDN (React) |
 | founderflow-cyan |
 | .vercel.app |
 +-----------+-----------+
 |
 | REST API (Axios + Sanctum)
 v
 +-----------+-----------+
 | Render.com (Laravel)|
 | founderflow.onrender |
 | .com |
 +-----------+-----------+
 |
 +---------------+---------------+
 | |
 v v
 +-----------+-----------+ +-------------+----------+
 | PostgreSQL (Neon) | | File Storage |
 | Primary Database | | (Public Disk / S3) |
 +-----------------------+ +------------------------+

Frontend Architecture

src/
 lib/
 api.ts Axios instance, base URL, interceptors
 store/
 authStore.ts Zustand — persisted auth state (user, token, role)
 routes/
 AppRoutes.tsx React Router — public, protected, and role-gated routes
 layouts/
 DashboardLayout.tsx Sidebar + Navbar shell for authenticated users
 pages/ Route-level page components (one per view)
 components/ Shared, reusable UI primitives (Button, Card, Modal, etc.)
 services/ One file per API domain (authService, transactionService, etc.)
 hooks/ Custom React hooks

Backend Architecture

app/
 Http/
 Controllers/ Thin controllers — validate input, delegate to services
 Middleware/ Auth, role checks, rate limiting
 Models/ Eloquent models with relationships defined
 Services/ Business logic layer (AuthService, etc.)
 Policies/ Laravel Gates/Policies for RBAC
routes/
 api.php All API endpoints, grouped by middleware
database/
 migrations/ Versioned schema changes
 seeders/ Development seed data

System Workflow

Authentication Flow

User submits credentials
 |
 v
POST /api/auth/login
 |
 v
AuthController validates credentials
 |
 +--- Fail ---> 401 Unauthorized
 |
 v
Sanctum issues API token
 |
 v
Token stored in Zustand (persisted to localStorage)
 |
 v
Axios attaches token to every subsequent request
 via Authorization: Bearer <token> header
 |
 v
Server middleware (auth:sanctum) validates on each request

Founder Financial Workflow

Founder logs in
 |
 v
FounderDashboard fetches:
 - analytics/summary (burn rate, runway, MRR)
 - transactions (recent activity)
 - startups (linked startup profile)
 |
 v
Founder records an Expense or Revenue
 -> Modal form opens (no page navigation)
 -> Zod validates input client-side
 -> POST /api/transactions
 -> TanStack Query invalidates cache
 -> Dashboard metrics recalculate automatically
 |
 v
Founder views Analytics page
 -> Revenue vs Expense bar chart (Recharts)
 -> Monthly breakdown table
 -> CSV export available

Investor Pipeline Workflow

Investor browses Discovery page
 GET /api/investments/discovery
 |
 v
Investor clicks "Express Interest" on a startup
 POST /api/investments/interest
 { startup_id, message }
 |
 v
Record created in investor_interests table
 status = "interested"
 |
 v
Founder sees new card on Investor Interests page
 GET /api/investments/startup-interests
 |
 v
Founder manages the deal pipeline:
 [Initial Interest]
 |
 |-- "Move to Discovery"
 v
 [Discovery] <- Intro calls, deck sharing
 |
 |-- "Schedule Funding Call"
 v
 [Funding Call] <- Term sheet discussions
 |
 |-- "Close Deal"
 v
 [Closed] <- Investment confirmed
 At any stage:
 |-- "Decline Interest" -> [Declined]
Each stage change:
 POST /api/investments/update-status
 { interest_id, status }
 -> Server verifies caller owns the startup
 -> Status saved to DB
 -> Frontend cache invalidated
 -> UI badge and action buttons update reactively

Tech Stack

Frontend

Backend

Infrastructure

Project Structure

fin/
├── README.md
├── docker-compose.yml
├── ARCHITECTURE.md
├── DECISIONS.md
│
├── frontend/
│ ├── index.html
│ ├── vite.config.ts
│ ├── vercel.json
│ ├── nginx.conf
│ ├── tsconfig.json
│ └── src/
│ ├── main.tsx
│ ├── App.tsx
│ ├── components/
│ │ ├── Button.tsx
│ │ ├── Card.tsx
│ │ ├── Modal.tsx
│ │ ├── Input.tsx
│ │ ├── FormInput.tsx
│ │ ├── Skeleton.tsx
│ │ ├── Navbar.tsx
│ │ ├── Sidebar.tsx
│ │ ├── DashboardShell.tsx
│ │ └── ProtectedRoute.tsx
│ ├── pages/
│ │ ├── LandingPage.tsx
│ │ ├── LoginPage.tsx
│ │ ├── RegisterPage.tsx
│ │ ├── FounderDashboard.tsx
│ │ ├── InvestorDashboard.tsx
│ │ ├── AdminDashboard.tsx
│ │ ├── ExpensesPage.tsx
│ │ ├── RevenuePage.tsx
│ │ ├── AnalyticsPage.tsx
│ │ ├── StartupsPage.tsx
│ │ ├── FounderInterestPage.tsx
│ │ ├── InvestorDiscoveryPage.tsx
│ │ ├── InvestorFundingPage.tsx
│ │ ├── SettingsPage.tsx
│ │ └── HelpCenterPage.tsx
│ ├── layouts/
│ │ └── DashboardLayout.tsx
│ ├── services/
│ │ ├── authService.ts
│ │ ├── transactionService.ts
│ │ ├── startupService.ts
│ │ └── analyticsService.ts
│ ├── store/
│ │ └── authStore.ts
│ ├── routes/
│ │ └── AppRoutes.tsx
│ ├── hooks/
│ └── lib/
│ ├── api.ts
│ └── utils.ts
│
└── backend/
 ├── artisan
 ├── composer.json
 ├── routes/
 │ └── api.php
 ├── app/
 │ ├── Http/
 │ │ └── Controllers/
 │ │ ├── AuthController.php
 │ │ ├── StartupController.php
 │ │ ├── TransactionController.php
 │ │ ├── InvestmentController.php
 │ │ ├── AnalyticsController.php
 │ │ ├── SettingsController.php
 │ │ ├── MediaController.php
 │ │ └── SearchController.php
 │ ├── Models/
 │ │ ├── User.php
 │ │ ├── Startup.php
 │ │ ├── Transaction.php
 │ │ ├── Investment.php
 │ │ ├── InvestorInterest.php
 │ │ └── FundingRequest.php
 │ └── Services/
 │ └── AuthService.php
 └── database/
 └── migrations/

Database Schema

users
 id bigint PK
 name varchar
 email varchar UNIQUE
 password varchar (hashed)
 role varchar -- 'founder' | 'investor' | 'admin'
 email_verified_at timestamp
 created_at, updated_at
startups
 id bigint PK
 user_id bigint FK -> users.id
 name varchar
 description text
 industry varchar
 funding_stage varchar
 team_size integer
 valuation decimal
 currency varchar -- 'USD' | 'INR'
 logo_url varchar
 created_at, updated_at
transactions
 id bigint PK
 startup_id bigint FK -> startups.id
 type varchar -- 'expense' | 'revenue'
 category varchar
 amount decimal
 currency varchar
 date date
 description text
 created_at, updated_at
funding_requests
 id bigint PK
 startup_id bigint FK -> startups.id
 target_amount decimal
 equity_offered decimal
 stage varchar
 status varchar -- 'pending' | 'active' | 'closed'
 pitch text
 created_at, updated_at
investor_interests
 id bigint PK
 user_id bigint FK -> users.id -- the investor
 startup_id bigint FK -> startups.id
 funding_request_id bigint FK -> funding_requests.id (nullable)
 status varchar -- 'interested' | 'discovery' | 'funding' | 'closed' | 'declined'
 message text
 created_at, updated_at
investments
 id bigint PK
 startup_id bigint FK -> startups.id
 investor_id bigint FK -> users.id
 amount decimal
 equity_percentage decimal
 status varchar
 created_at, updated_at

API Reference

Authentication

Startups

Transactions

Analytics

Investments

Settings & Media

Request / Response Format

{
 "success": true,
 "message": "Operation completed successfully.",
 "data": { ... }
}

{
 "message": "Descriptive error message.",
 "errors": {
 "field_name": ["Validation error detail."]
 }
}

Authentication & Authorization

Investor Pipeline

interested -> discovery -> funding -> closed
 |
 declined (from any stage)

Local Development

Prerequisites

1. Clone

git clone https://github.com/Akhand0ps/fin.git
cd fin

2. Backend

cd backend
composer install
cp .env.example .env
php artisan key:generate

php artisan migrate
php artisan serve
# API available at http://localhost:8000

3. Frontend

cd frontend
npm install

VITE_API_URL=http://localhost:8000

npm run dev
# App available at http://localhost:5173

4. Docker (Alternative)

docker-compose up --build

Deployment

Frontend — Vercel

Backend — Render

Database — Neon

Environment Variables

Backend (backend/.env)

APP_NAME=FounderFlow
APP_ENV=production
APP_KEY=
APP_URL=https://founderflow.onrender.com
DB_CONNECTION=pgsql
DB_URL=postgresql://user:password@host/database?sslmode=require
SANCTUM_STATEFUL_DOMAINS=founderflow-cyan.vercel.app
SESSION_DOMAIN=.founderflow-cyan.vercel.app
FRONTEND_URL=https://founderflow-cyan.vercel.app
QUEUE_CONNECTION=sync
CACHE_DRIVER=file

Frontend (frontend/.env)

VITE_API_URL=https://founderflow.onrender.com

Contributing

Commit Convention

License

Author