Introduction
Sicua is a comprehensive analysis platform that combines static code analysis with AI-powered insights to help you understand, optimize, and maintain your Next.js and React TypeScript projects.
Sicua works as a two-part system: a CLI package that analyzes your codebase locally, and a web platform where you visualize results and receive AI-powered recommendations.
How It Works
Local Analysis
Run npx sicua in your Next.js/React TypeScript project to perform comprehensive static analysis and generate a detailed JSON report of your codebase.
Web Platform
Upload your JSON report to our web platform to visualize results, interact with data, and receive AI-powered insights and recommendations.
Analysis Capabilities
Sicua provides 33 different types of analysis across multiple dimensions of your codebase:
Component Architecture
- Component Mapping with interactive graph visualization
- Component connections and relationship analysis
- Dead code detection through advanced graph traversal
- Orphan node identification and cleanup suggestions
- File structure mapping for better project organization
| Metric | What It Measures |
|---|---|
| Network Analysis | Total nodes, edges, max depth, average connections |
| Community Detection | Modularity score, community sizes, connected groups |
| Dependency Health | Circular dependencies, strongly connected components |
| Architecture Quality | Bridge components, influential components, isolated files |
Code Quality
- Cyclomatic Complexity analysis for decision point measurement
- Cognitive Complexity assessment for mental load evaluation
- Maintainability Index scoring for long-term code health
- Coupling Degree analysis for component independence
High complexity scores indicate components that may be difficult to understand, test, and maintain.
Error Handling & Risk
- Error Handling Risk Analysis for crash prevention
- Component-level and function-level error handling coverage
- Error boundary implementation tracking
- Async operation safety assessment
TypeScript & Type Safety
- Type System Metrics including interfaces, PropType adoption
- Component type coverage analysis
- Complex type identification and simplification suggestions
- Duplicate type detection with unification recommendations
- Type organization and namespace optimization
Performance & Dependencies
- Dependency analysis for unused and missing packages
- Circular dependency detection and resolution paths
- Zombie cluster identification for dead code removal
- Component deduplication opportunities
SEO & Accessibility
- SEO coverage and health analysis for better search rankings
- Accessibility metrics with detailed error identification
- Translation coverage analysis for internationalization
- Missing translation detection with coverage insights
Accessibility & Security
- Accessibility Analysis with WCAG compliance tracking (A, AA, AAA levels)
- Component-level accessibility scoring and violation detection
- Security vulnerability assessment for API routes and configurations
- Dependency security analysis with vulnerability tracking
| Analysis Type | What It Measures |
|---|---|
| A11y Violations | Missing alt text, ARIA labels, semantic structure issues |
| WCAG Compliance | Compliance level assessment with passed/failed criteria |
| Security Risks | Critical, high, medium, low risk vulnerabilities |
| API Security | Route authentication, input validation, security headers |
| Dependency Safety | Vulnerable packages, outdated dependencies |
Advanced Features
Component Flow Visualization
Interactive route-based visualization that maps your project’s routing structure. Select any route to see exactly which components render on that page and under what conditions, helping you understand your application’s component hierarchy and conditional rendering patterns.
AI-Powered Insights
Our multi-model AI system analyzes your top 20 most problematic components and provides:
- Architectural improvements with design pattern recommendations
- Performance optimizations with measurable impact estimates
- Error handling enhancements for better reliability
- Type safety improvements for development confidence
- SEO optimizations for better search visibility
Smart Deduplication
AI-powered analysis identifies similar components and suggests unification strategies to reduce code duplication and improve maintainability.
33 Analysis Types: From basic metrics to advanced AI recommendations, Sicua provides the most comprehensive analysis available for React/Next.js projects.
What You’ll Discover
After running Sicua analysis, you’ll have clear visibility into:
- 🎯 Critical Issues: Components that need immediate attention
- 📊 Project Health: Overall codebase quality metrics
- 🔗 Architecture Insights: How your components connect and depend on each other
- ⚡ Performance Opportunities: Specific optimizations with expected impact
- 🛡️ Risk Assessment: Potential failure points and error handling gaps
- 🎨 Code Quality: Maintainability and complexity across your entire project
Whether you’re working on a small project or a large enterprise application, Sicua provides the insights you need to build better, more maintainable React applications.