Insightful is a comprehensive cross-platform solution that leverages the power of Large Language Models to automatically transcribe and summarize meeting recordings. Built as a modern monorepo, it provides seamless experiences across web and mobile platforms with shared business logic and consistent user experiences.
Insightful consists of multiple applications working together to provide a unified meeting analysis experience:
- 🌐 Web Application - Full-featured web interface with live recording and file upload capabilities
- 📱 Mobile Applications - Native iOS and Android apps built with React Native (Coming Soon)
- 🔧 Shared Packages - Common database schemas, configurations, and utilities
- Web Application - Production-ready with advanced features including:
- Live browser-based recording with MediaRecorder API
- File upload with drag-and-drop interface
- Real-time AI processing with Google Gemini 1.5 Pro
- WebSocket-based live status updates
- Responsive design optimized for mobile browsers
- GitHub OAuth authentication
- Comprehensive testing suite
- Mobile Applications - React Native implementation planned with:
- Native recording capabilities
- Offline-first architecture
- Push notifications for job completion
- Native file system integration
- Biometric authentication support
┌─────────────────────────────────────────────────────────────┐
│ Insightful Platform │
│ AI Meeting Summarizer Ecosystem │
└─────────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────┐
│ Client Applications │
├─────────────────────────────────────────────────────────────┤
│ 📱 Mobile Apps (React Native) │ 🌐 Web App (Next.js) │
│ • iOS Application │ • Browser Interface │
│ • Android Application │ • Live Recording │
│ • Native Recording │ • File Upload │
│ • Offline Support │ • Real-time Updates │
│ • Push Notifications │ • Responsive Design │
└─────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────┐
│ Shared Backend Services │
├─────────────────────────────────────────────────────────────┤
│ • Authentication (NextAuth.js + OAuth) │
│ • File Storage (Cloudflare R2) │
│ • AI Processing (Google Gemini 1.5 Pro) │
│ • Real-time Updates (Supabase Realtime) │
│ • Task Queue (Upstash QStash) │
└─────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────┐
│ Shared Packages │
├─────────────────────────────────────────────────────────────┤
│ 📦 database/ # Prisma schemas & migrations │
│ 📦 eslint-config/ # Shared linting rules │
│ 📦 typescript-config/ # TypeScript configurations │
│ 📦 ui-components/ # Shared UI components (Planned) │
│ 📦 api-client/ # API client library (Planned) │
└─────────────────────────────────────────────────────────────┘
A full-featured Next.js application providing comprehensive meeting analysis capabilities.
Key Features:
- 🎙️ Live Recording - Browser-based recording with real-time processing
- 📁 File Upload - Drag-and-drop interface for audio/video files
- 🤖 AI Analysis - Automatic transcription and summarization
- 🔄 Real-time Updates - WebSocket-based status synchronization
- 📱 Mobile Responsive - Optimized for all screen sizes
- 🔐 Secure Authentication - GitHub OAuth integration
Tech Stack:
- Next.js 14 with App Router
- TypeScript & Tailwind CSS
- Prisma ORM with PostgreSQL
- Supabase for real-time features
- Google Gemini 1.5 Pro for AI processing
📖 Detailed Web App Documentation
Native mobile applications built with React Native, providing optimized mobile experiences.
Planned Features:
- 📱 Native Recording - High-quality audio recording with device optimization
- 🔄 Offline Support - Queue recordings for processing when online
- 🔔 Push Notifications - Real-time alerts for job completion
- 📂 File Integration - Native file system access and sharing
- 🔒 Biometric Auth - Fingerprint and Face ID support
- 🎨 Native UI - Platform-specific design patterns
Planned Tech Stack:
- React Native with Expo
- TypeScript
- React Query for state management
- Native modules for recording
- Shared API client from web app
Centralized database configuration and schemas using Prisma ORM.
Contents:
- Database schema definitions
- Migration files
- Seed data scripts
- Type-safe database client
Shared ESLint configuration for consistent code quality across all applications.
Common TypeScript configurations optimized for different application types.
Shared React components library for consistent UI across web and mobile.
Type-safe API client library for communication with backend services.
-
Clone the repository:
git clone https://github.com/your-username/insightful.git cd insightful -
Install dependencies:
pnpm install
-
Set up environment variables:
cp .env.example .env # Fill in the required values in .env -
Initialize the database:
pnpm prisma db push --schema=./packages/database/prisma/schema.prisma
-
Start development servers:
# Start all applications pnpm run dev # Or start specific applications pnpm run dev --filter=web-app
# Build all applications
pnpm run build
# Run linting
pnpm run lint
# Format code
pnpm run format
# Type checking
pnpm run check-typesThe web application is optimized for deployment on Vercel.
- Connect your GitHub repository to Vercel
- Set the root directory to
apps/web-app - Configure environment variables
- Deploy automatically on push to main branch
Mobile applications will be distributed through:
- iOS: App Store via Expo Application Services (EAS)
- Android: Google Play Store via EAS
- Enterprise: Over-the-air updates via Expo Updates
- Core web application with live recording
- File upload and AI processing
- Real-time status updates
- Responsive mobile web interface
- Production deployment
- React Native project setup
- Shared component library
- Native recording implementation
- Offline-first architecture
- Push notification system
- Multi-language support
- Advanced AI features (speaker identification, sentiment analysis)
- Team collaboration features
- Integration with calendar applications
- Export to various formats (PDF, Word, etc.)
- Single Sign-On (SSO) integration
- Advanced analytics and reporting
- Custom AI model training
- White-label solutions
- API for third-party integrations
We welcome contributions from the community! Please see our Contributing Guide for details.
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Make your changes
- Add tests for new functionality
- Ensure all tests pass (
pnpm test) - Commit your changes (
git commit -m 'Add amazing feature') - Push to your branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
- Next.js for the amazing React framework
- React Native for cross-platform mobile development
- Turborepo for monorepo management
- Google Gemini for AI capabilities
- Supabase for real-time database features
- Vercel for seamless deployment
Built with ❤️ by the Insightful Team