Platform Overview

Mission Statement

TechInvestor curates verified utility tokens and technology-driven startups so retail investors can fund real-world adoption with confidence. Every surface (web, Android, iOS) shares the same mission narrative, diligence status copy, and contact channels.

Architecture Snapshot

• Web: Next.js 14 App Router app (TypeScript, Tailwind) in web/. Hosts the public marketing site, data submission form, and lightweight intake agent.

• APIs: Server components under web/src/app/api/. Present endpoints include the submissions intake (/api/submissions) and dashboard snapshot (/api/dashboard). Both run inside the Next.js server runtime.

• KYC Integration: Optional Persona sessions initiated via /api/kyc/initiate and resolved through /api/kyc/callback, updating the dashboard store so verified teams receive a green flag.

• Mobile: Two parity apps under mobile/. Android uses Jetpack Compose in TechInvestorAndroid, iOS uses SwiftUI in TechInvestorMobile.

• Docs & Guidance: Product-wide instructions live in README.md, .github/copilot-instructions.md, and this /docs directory.

Contributor Quick Start

1. Install Node 18+ (portable install is acceptable) and add it to the PATH.

2. From web/, run npm install then:

   • npm run dev for local preview

   • npm run lint before committing

   • npm run build to emulate Netlify

3. Mirror copy or workflow changes in:

   • mobile/TechInvestorAndroid/app/src/main/java/com/techinvestor/mobile/MainActivity.kt

   • mobile/TechInvestorMobile/TechInvestorMobile/ContentView.swift

4. Update verification steps and analyst processes in both README.md and docs/verification-process.md.

5. Record new automation or backend behaviour in docs/api.md.

Key Principles

• Parity First: Every content or workflow tweak ships on web + Android + iOS together.

• Transparent Diligence: Keep the eight-stage verification pipeline visible and consistent for investors and analysts.

• Privacy Promise: Submissions are auto-purged within 24 hours; documentation and UI copy must reflect this guarantee.

• Agent Enablement: Seed deterministic responses in the intake agent until a live AI backend comes online.

• Deployment Ready: Netlify builds the web folder via npm run build with @netlify/plugin-nextjs. Keep serverless endpoints self-contained.