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
- Compliance Ready: Meet healthcare data standards and regulations
- 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
- 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: HTTPS, secure credential management, input validation
- Performance Optimized: Redis caching, CDN support, optimized builds
- 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 shadcn/ui components
- Backend: NestJS with WHO ICD-11 API integration
- Caching: Redis for optimal performance
- Database: Optional database integration ready
- 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
# 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
# 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
// Search ICD-11 codes
GET /api/icd11/search?q=diabetes&limit=10
// Get specific entity details
GET /api/icd11/entity/{entityId}
// Browse hierarchical structure
GET /api/icd11/entity/{entityId}/children
// Health check endpoint
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: security@your-domain.com
- 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
- ✅ Comprehensive documentation
- 🔄 FHIR integration support
- 🔄 Advanced search filters
- 🔄 Bulk code import/export
- 🔄 Analytics dashboard
- 📋 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.