The Integrated Health Engagement Platform (IHEP) is a Next.js-based healthcare aftercare platform with digital twin technology, wellness tracking, and financial empowerment tools.
New to the project? See GETTING_STARTED.md for all setup options.
The fastest way to get started is with GitHub Codespaces:
- Click the "Open in GitHub Codespaces" badge above
- Wait for the environment to set up (2-3 minutes)
- Update
DATABASE_URLin.env.local - Run
npm run dev
See CODESPACES_SETUP.md for detailed instructions.
# Clone the repository
git clone https://github.com/ihep-platform/ihep.app.git
cd ihep.app
# Run the setup script
bash scripts/dev-setup.sh
# Validate your setup
bash scripts/validate-setup.sh
# Start the development server
npm run devOpen http://localhost:5000 with your browser.
- GETTING_STARTED.md - Start here! All setup options and quick reference
- CODESPACES_SETUP.md - GitHub Codespaces detailed guide
- QUICK_START.md - Local development setup details
- PRODUCTION_CHECKLIST.md - Pre-launch checklist (120+ items)
- DEPLOYMENT.md - GCP Cloud Run deployment guide
- SECURITY.md - Security guidelines and PHI handling
- TODO.md - Current tasks and project status
- PROJECT_SUMMARY.md - Comprehensive project overview
- Framework: Next.js 16.1.5 with App Router
- Language: TypeScript 5 (strict mode)
- UI: React 19, Tailwind CSS 4, shadcn/ui
- Database: PostgreSQL with Drizzle ORM
- Authentication: NextAuth.js v4
- Testing: Vitest + React Testing Library (113+ tests)
- Security: Post-Quantum Cryptography (Kyber, ML-DSA)
- 3D Graphics: Three.js for Digital Twin visualization
- Deployment: GCP Cloud Run with Docker
ihep.app/
├── src/ # Main application code
│ ├── app/ # Next.js App Router pages
│ ├── components/ # React components
│ ├── lib/ # Utilities and client logic
│ ├── hooks/ # Custom React hooks
│ └── shared/ # Shared schemas and types
├── .devcontainer/ # GitHub Codespaces configuration
├── scripts/ # Helper scripts
├── public/ # Static assets
└── docs/ # Additional documentation
# Validation
bash scripts/validate-setup.sh # Verify your setup is correct
# Development
npm run dev # Start dev server (uses webpack for Three.js compatibility)
npm run dev:turbo # Start dev server with Turbopack
# Building & Testing
npm run build # Production build
npm run start # Start production server
npm run check # TypeScript type checking
npm run lint # ESLint
npm test # Run tests
npm run test:watch # Run tests in watch mode
# Database
npm run db:push # Push schema changes to database
npm run db:studio # Open Drizzle Studio
npm run db:generate # Generate migrations
npm run db:migrate # Run migrationsCopy .env.example to .env.local and configure:
# Required
NEXTAUTH_URL=http://localhost:5000
NEXTAUTH_SECRET=<generated-secret>
DATABASE_URL=postgresql://user:password@host:port/database
# Optional
GOOGLE_CLIENT_ID=<your-google-client-id>
GITHUB_CLIENT_ID=<your-github-client-id>
SENTRY_DSN=<your-sentry-dsn>Generate secrets with: bash scripts/generate-secrets.sh
The platform is configured for deployment to GCP Cloud Run. See DEPLOYMENT.md for detailed instructions.
Before deploying to production, review PRODUCTION_CHECKLIST.md.
This project uses:
- Conventional Commits for commit messages
- ESLint for code quality
- TypeScript strict mode
- Vitest for testing
See CLAUDE.md for AI assistance attribution.
See LICENSE file for details.
- Documentation: See files in the repository root
- Issues: GitHub Issues
- Contact: jason@ihep.app
Version: 2.0.0
Status: Production-ready foundation, database connection required
See TODO.md for current tasks and PROJECT_SUMMARY.md for detailed project information.