A comprehensive, production-ready platform for building modern ICD-11 healthcare applications. This platform combines a powerful CLI tool (create-icd11-app) with a complete full-stack application template, enabling healthcare organizations to rapidly deploy WHO ICD-11 compliant applications with professional branding and enterprise-grade infrastructure.
Create a new ICD-11 healthcare application in minutes:
npx create-icd11-app my-healthcare-appThe interactive wizard will guide you through:
- Template Selection: Full-stack, frontend-only, API-only, or minimal
- Healthcare Branding: Custom colors, logos, and organization details
- WHO API Configuration: Secure credential setup with validation
- Deployment Options: Docker, AWS, Azure, GCP with CI/CD pipelines
- Development Setup: Redis, testing, and development environment
For developers who want to customize the platform itself:
git clone https://github.com/alirezarezvani/icd11-nextjs-nestjs-boilerplate.git
cd icd11-nextjs-nestjs-boilerplate
npm run install:all
npm run devThe International Classification of Diseases, 11th Revision (ICD-11) is the World Health Organization's global standard for diagnostic information in health records and death certificates. This platform provides seamless integration with the WHO ICD-11 API, enabling healthcare applications to:
- Search Medical Codes: Fast, accurate ICD-11 code lookup
- Navigate Hierarchies: Browse the complete ICD-11 classification structure
- Access Definitions: Detailed descriptions and clinical guidance
- Ensure Compliance: WHO-validated medical coding standards
┌─────────────────────────────────────────────────────────────────┐
│ ICD-11 Healthcare Platform │
├─────────────────────────────────────────────────────────────────┤
│ CLI Tool (create-icd11-app) │ Boilerplate Repo │
│ ├── Interactive Setup Wizard │ ├── Next.js Frontend │
│ ├── Template Engine │ ├── NestJS Backend │
│ ├── Branding System │ ├── Redis Caching │
│ ├── Deployment Generators │ ├── WHO API Client │
│ └── CI/CD Pipeline Creation │ └── TypeScript Types │
├─────────────────────────────────────────────────────────────────┤
│ Multi-Cloud Deployment Support │
│ ├── Docker Compose │ ├── AWS ECS/Fargate │
│ ├── Azure Container Apps │ └── Google Cloud Run │
└─────────────────────────────────────────────────────────────────┘
- WHO ICD-11 Integration: Complete API client with OAuth2 authentication
- Medical Code Search: Fast, accurate search with advanced filtering
- Hierarchical Navigation: Full support for ICD-11 structure and relationships
- Clinical Definitions: Detailed descriptions and usage guidelines
- User Authentication: Enterprise-grade JWT authentication with role-based access control
- Compliance Ready: Meet healthcare data standards and regulations with audit trails
- Interactive CLI: Guided setup with intelligent defaults
- Multiple Templates: Choose the right architecture for your needs
- Hot Reloading: Fast development with live code updates
- Type Safety: Full TypeScript coverage across frontend and backend
- Authentication System: Complete JWT-based auth with protected routes and user management
- Testing Suite: Comprehensive unit, integration, and e2e tests
- API Documentation: Auto-generated Swagger/OpenAPI documentation
- Custom Colors: Primary and secondary brand colors
- Logo Integration: Easy logo replacement and branding
- Organization Info: Customizable contact and support information
- Responsive Design: Mobile-first, accessible user interface
- Professional UI: Material Design principles for healthcare applications
- Multi-Cloud Support: Deploy to AWS, Azure, GCP, or Docker
- CI/CD Pipelines: GitHub Actions and GitLab CI integration
- Security First: JWT authentication, HTTPS, secure credential management, input validation
- User Management: Role-based access control with audit logging and account security
- Performance Optimized: Redis caching, CDN support, optimized builds
- Database Integration: PostgreSQL with TypeORM for user data and audit trails
- Monitoring: Health checks, logging, error tracking
- Scalability: Auto-scaling and load balancing configurations
Perfect for healthcare organizations needing a complete solution
- Frontend: Next.js with Material-UI components and authentication
- Backend: NestJS with JWT authentication, WHO ICD-11 API integration
- Database: PostgreSQL with TypeORM for user management
- Authentication: Complete JWT-based auth with role-based access control
- Caching: Redis for optimal performance
- Deployment: Full Docker containerization
- CI/CD: Complete pipeline setup
npx create-icd11-app my-healthcare-platformIdeal for client-side applications or static deployments
- Technology: Next.js application with ICD-11 interface
- API: Mock responses for development
- Deployment: Static site generation ready
- Performance: Optimized for CDN delivery
- Customization: Full branding support
npx create-icd11-app my-frontend-app --template frontend-onlyPerfect for microservices or backend-focused deployments
- Technology: NestJS backend service
- Integration: Complete WHO API integration
- Caching: Redis performance optimization
- Documentation: OpenAPI/Swagger specification
- Containerization: Docker-ready deployment
npx create-icd11-app my-api-service --template api-onlyQuick development setup with essential features
- Technology: Basic Next.js + NestJS
- Features: Core ICD-11 functionality
- Dependencies: Minimal for fast startup
- Customization: Easy to extend and modify
npx create-icd11-app my-minimal-app --template minimal- Next.js 13+: React framework with App Router
- TypeScript: Type-safe development
- shadcn/ui: Modern component library
- Tailwind CSS: Utility-first styling
- React Hook Form: Form management
- React Query: Server state management
- NestJS: Progressive Node.js framework
- TypeScript: Type-safe development
- Redis: High-performance caching
- Swagger: API documentation
- Jest: Testing framework
- Class Validator: Input validation
- Docker: Containerization
- Docker Compose: Multi-container orchestration
- GitHub Actions: CI/CD automation
- AWS: Cloud infrastructure
- Azure: Cloud platform
- Google Cloud: Cloud services
- Node.js: 16.0.0 or higher
- npm: 8.0.0 or higher
- Git: Latest version
- Docker: 20.10+ (optional, for containerized deployment)
- Visit the WHO ICD-11 API Portal
- Register for a developer account
- Create a new application
- Obtain your Client ID and Client Secret
- Review the API Terms of Service
- Local Redis: Version 6.0+ for development
- Docker Redis: Automatically configured by CLI
- Cloud Redis: Managed Redis for production deployments
- PostgreSQL: Version 12+ for user management and authentication
- Local Development: PostgreSQL running on localhost:5432
- Docker PostgreSQL: Automatically configured by CLI
- Cloud Database: Managed PostgreSQL for production deployments
The platform includes a comprehensive enterprise-grade authentication system with:
- JWT-Based Authentication: Secure access and refresh token pattern
- Role-Based Access Control: Four-tier permission system (USER, HEALTHCARE_PROVIDER, ORG_ADMIN, SUPER_ADMIN)
- Account Security: Progressive account lockout and audit logging
- SSR-Safe Storage: Seamless authentication across server and client rendering
- Public/Private Access: ICD-11 search remains publicly accessible while admin features require authentication
- Password Security: bcrypt hashing with configurable rounds
- Token Expiration: Access tokens (15 minutes), refresh tokens (7 days)
- Account Lockout: 5 failed login attempts = 30-minute lockout
- Audit Logging: HIPAA-compliant trails for all authentication events
- Session Management: Single device logout or logout from all devices
enum UserRole {
USER = 'USER', // Basic user access
HEALTHCARE_PROVIDER = 'HEALTHCARE_PROVIDER', // Healthcare professional access
ORG_ADMIN = 'ORG_ADMIN', // Organization administrator
SUPER_ADMIN = 'SUPER_ADMIN' // Platform super administrator
}- AuthModal: Seamless login/register modal integration
- ProtectedRoute: Higher-order components for route protection
- UserMenu: Profile management and logout functionality
- AuthContext: React Context for global authentication state
# Create PostgreSQL database
createdb icd11_healthcare_app
# Environment variables (backend/.env)
DATABASE_HOST=localhost
DATABASE_PORT=5432
DATABASE_USERNAME=your_username
DATABASE_PASSWORD=your_password
DATABASE_NAME=icd11_healthcare_app# Generate secure JWT secrets (minimum 32 characters)
JWT_SECRET=your_super_secure_jwt_secret_here_32_chars_min
JWT_REFRESH_SECRET=your_refresh_secret_here_also_32_chars_min
# Optional: Customize token expiration
JWT_EXPIRATION=15m
JWT_REFRESH_EXPIRATION=7d// pages/_app.tsx - Wrap app with AuthProvider
import { AuthProvider } from '../contexts/AuthContext';
function MyApp({ Component, pageProps }) {
return (
<AuthProvider>
<Component {...pageProps} />
</AuthProvider>
);
}
// components/ProtectedPage.tsx - Protect routes
import { ProtectedRoute } from '../components/Auth';
export default function AdminPage() {
return (
<ProtectedRoute requiredRole="HEALTHCARE_PROVIDER">
<div>Protected healthcare provider content</div>
</ProtectedRoute>
);
}
// hooks/useAuth.ts - Access auth state
const { user, isAuthenticated, login, logout } = useAuth();# Interactive setup with full customization
npx create-icd11-app my-healthcare-app
# Quick setup with defaults
npx create-icd11-app my-healthcare-app --yes
# Specific template
npx create-icd11-app my-healthcare-app --template api-onlycd my-healthcare-app
# Add WHO API credentials to backend/.env
ICD11_CLIENT_ID=your_client_id_here
ICD11_CLIENT_SECRET=your_client_secret_here
# Database configuration
DATABASE_HOST=localhost
DATABASE_PORT=5432
DATABASE_USERNAME=your_username
DATABASE_PASSWORD=your_password
DATABASE_NAME=icd11_healthcare_app
# JWT authentication secrets (minimum 32 characters each)
JWT_SECRET=your_super_secure_jwt_secret_here_32_chars_minimum
JWT_REFRESH_SECRET=your_refresh_secret_here_also_32_chars_minimum
# Redis configuration
REDIS_HOST=localhost
REDIS_PORT=6379
# Customize frontend branding in frontend/.env.local
NEXT_PUBLIC_PRIMARY_COLOR=#2e7d32
NEXT_PUBLIC_SECONDARY_COLOR=#ff9800# Start all services
npm run dev
# Or start individually
npm run dev:frontend # Frontend at http://localhost:3000
npm run dev:backend # Backend at http://localhost:3003
npm run dev:redis # Redis at localhost:6379# Docker deployment
docker-compose -f docker-compose.prod.yml up -d
# Cloud deployment (AWS example)
./scripts/deploy-aws.sh
# CI/CD deployment
git push origin main # Triggers automated deploymentWhen the backend is running, access comprehensive API documentation:
- Development: http://localhost:3003/api/docs
- Production: https://your-domain.com/api/docs
// Authentication endpoints
POST /api/auth/register // User registration
POST /api/auth/login // User login
POST /api/auth/refresh // Token refresh
POST /api/auth/logout // User logout
GET /api/auth/profile // User profile
// ICD-11 search endpoints (public)
GET /api/icd11/search?q=diabetes&limit=10
GET /api/icd11/entity/{entityId}
GET /api/icd11/entity/{entityId}/children
// System endpoints
GET /api/health- CLI Documentation: Complete guide to the create-icd11-app CLI tool
- Architecture Guide: Technical architecture and design decisions
- Deployment Guide: Multi-cloud deployment strategies
- Development Guide: Local development setup and contribution guidelines
- API Reference: Complete API documentation and examples
- WHO ICD-11 API Documentation: Official WHO API documentation
- Healthcare Compliance Guide: Healthcare data standards and regulations
- Security Best Practices: Security guidelines for healthcare applications
- Diagnostic Coding: Accurate ICD-11 code lookup for patient records
- Clinical Documentation: Standardized medical terminology
- Insurance Claims: Proper coding for claim processing
- Quality Metrics: Standardized reporting and analytics
- Electronic Health Records: Integrated ICD-11 coding workflows
- Clinical Decision Support: Code-based clinical recommendations
- Research Data: Standardized data for medical research
- Population Health: Epidemiological analysis and reporting
- EHR Integration: Add ICD-11 functionality to existing systems
- Practice Management: Streamlined coding workflows
- Billing Systems: Accurate diagnostic code management
- Telehealth Platforms: Remote diagnosis coding support
- GitHub Issues: Technical support and bug reports
- Discussions: Community discussions and questions
- Documentation: Complete platform documentation
We welcome contributions from the healthcare development community:
- Bug Reports: Help us improve the platform
- Feature Requests: Suggest new healthcare-focused features
- Code Contributions: Submit pull requests for improvements
- Documentation: Help improve and expand documentation
See our Contributing Guide for details.
For security-related issues or vulnerabilities:
- Security Policy: Security guidelines and reporting
- Private Reporting: [email protected]
- Response Time: We aim to respond to security issues within 24 hours
- ✅ Complete WHO ICD-11 API integration
- ✅ Multi-template CLI tool
- ✅ Docker and multi-cloud deployment
- ✅ Healthcare branding system
- ✅ Multi-language support (EN, ES, FR, AR, ZH, RU)
- ✅ Enhanced UI/UX with responsive design
- ✅ Search performance optimization with debouncing
- ✅ URL routing improvements with entity ID encoding
- ✅ Enterprise authentication system with JWT and RBAC
- ✅ PostgreSQL database integration with TypeORM
- ✅ User management with role-based access control
- ✅ Audit logging and account security features
- ✅ Comprehensive documentation
- 🔄 FHIR integration support
- 🔄 Advanced search filters with user preferences
- 🔄 Bulk code import/export with user permission controls
- 🔄 Analytics dashboard with role-based data access
- 🔄 Enhanced user profile management
- 🔄 Organization management and multi-tenancy support
- 📋 HL7 FHIR CodeSystem integration
- 📋 Machine learning-based code suggestions
- 📋 Audit trail and compliance reporting
- 📋 Mobile application templates
- 📋 Integration with major EHR systems
This project is licensed under the MIT License - see the LICENSE file for details.
- WHO ICD-11 API: Subject to WHO Terms of Service
- Open Source Components: Various MIT and Apache 2.0 licenses
- Template Assets: CC0 and MIT licensed resources
This platform was created by Alireza Rezvani, CTO @ LINDERA, a Senior Solution Architect and Senior Fullstack Software Engineer. With extensive experience in modern web & mobile technologies, SecDevOps, and healthcare systems integration, Alireza developed this platform to provide a robust foundation for WHO ICD-11 compliant healthcare applications.
- Healthcare Integration: Extensive experience with healthcare data standards
- Full-Stack Development: Modern web technologies and cloud architecture
- Enterprise Systems: Large-scale healthcare application deployment
- Open Source: Committed to advancing healthcare technology through open source
Ready to build your ICD-11 healthcare application? Choose your path:
Use the CLI tool for rapid deployment with custom branding:
npx create-icd11-app my-healthcare-platformFork the repository and customize the platform:
git clone https://github.com/alirezarezvani/icd11-nextjs-nestjs-boilerplate.gitStart with the comprehensive documentation:
Build modern, compliant, and scalable ICD-11 healthcare applications with confidence.