IterativAnalytics is a comprehensive AI-powered platform for African startups, providing financial intelligence and capital access solutions.
# Iterativ Analytics
> AI-powered analytics platform for African startups and investors
## π Overview
Iterativ Analytics is an enterprise-grade full-stack application built with modern technologies and best practices. It provides comprehensive analytics, document management, and AI-powered insights for startups and investors.
## π¨ Design System
IterativAnalytics features a comprehensive design system ensuring consistency, accessibility, and quality across all touchpoints.
**π Documentation:**
- **DESIGN_PRINCIPLES.md** - Core design principles that guide all decisions
- **DESIGN_SYSTEM.md** - Complete design system guide with strategic guidelines
- **DESIGN_SYSTEM_QUICKREF.md** - Quick reference for daily development
**Key Features:**
- π― African-first design approach (optimized for connectivity and mobile)
- βΏ WCAG 2.1 AA accessibility standards
- π± Mobile-first responsive components
- β‘ Performance-optimized patterns
- π¨ Comprehensive component library (70+ components)
- π Dark mode and sector-based theming
- π§ Design tokens and CSS variables
**Quick Start:**
```tsx
import { Button, Card, Badge } from '@/components/ui';
Revenue Growth
+12.5%
```
## ποΈ Architecture
### Technology Stack
**Frontend:**
- React 18 with TypeScript
- Vite for build tooling
- TanStack Query for data fetching
- Tailwind CSS + shadcn/ui for styling
- Wouter for routing
- Zod for validation
- Firebase Authentication
**Backend:**
- Node.js + Express
- TypeScript (ESM)
- Drizzle ORM + PostgreSQL
- Zod for validation
- Structured logging
- Comprehensive error handling
### Project Structure
```
βββ client/ # Frontend application
β βββ src/
β β βββ components/ # React components
β β β βββ common/ # Reusable components
β β β βββ ui/ # shadcn/ui components
β β β βββ ...
β β βββ hooks/ # Custom React hooks
β β βββ lib/ # Utilities and helpers
β β β βββ api/ # API client and services
β β β β β¦