An iOS application that tracks users' IQ scores over time through periodic testing with AI-generated questions.
This is a monorepo containing all components of the AIQ application:
aiq/
├── ios/ # SwiftUI iOS application
├── backend/ # Backend API server
├── question-service/ # AI-powered question generation service
├── scripts/ # Pre-commit hooks (float checks, magic numbers)
├── docs/ # Project documentation
├── deployment/ # AWS Terraform configs (legacy)
├── website/ # Privacy policy, terms of service
├── .claude/ # Claude Code config, skills, and scripts
├── .github/ # CI/CD workflows, PR template, Dependabot
├── README.md # This file
└── aiq_types/ # Shared Python domain types (QuestionType, etc.)
- Native iOS application built with SwiftUI (iOS 16+)
- Gamified IQ test experience with intuitive UI
- Historical score tracking and trend visualization
- Push notification support for periodic test reminders
- Comprehensive design system with unified styling
- Full accessibility support (VoiceOver, Dynamic Type)
- Built-in analytics and performance monitoring
- FastAPI REST API server with async support
- JWT-based authentication and user management
- Question serving and response storage
- IQ score calculation and analytics
- Push notification scheduling (APNs integration)
- Rate limiting and security features
- Comprehensive logging and monitoring
- Autonomous service for generating novel IQ test questions
- Multi-LLM architecture with quality judge
- Ensures continuous supply of fresh questions
- Prevents question repetition per user
For detailed component information, see individual READMEs:
- Backend API - FastAPI server, database, and migrations
- Question Service - AI question generation service
- iOS App - SwiftUI iOS application
- Backend Deployment - Railway production deployment
- Question Service Deployment - Railway cron service
- AWS Infrastructure - Terraform configs (legacy)