Sicua

A comprehensive static analysis tool for TypeScript/React projects that generates detailed insights about your codebase structure, complexity, and potential issues.

> ⚠️ Alpha Release - Currently in alpha stage. Best compatibility with Next.js 13.4+ TypeScript projects using the App Router. Pages Router and pure React projects are supported but may have limited features.

Installation

bash

npm install -g sicua





Quick Analysis

bash

Analyze current directory

npx sicua





Features



$3



- Component Analysis: Circular dependencies, zombie clusters, component relationships

- Complexity Metrics: Cognitive complexity, cyclomatic complexity, maintainability index

- Dependency Analysis: Unused and missing package dependencies

- Function Analysis: Parameter parsing, async detection, type resolution

- Error Handling: Error boundaries, try-catch blocks, error patterns



$3



- SEO Analysis: Meta tags, structured data, performance optimization

- Translation Coverage: Missing translations, duplicate keys

- Type Analysis: Complex types, duplicate types, usage patterns

- Security Analysis: Basic Security Analysis and vulnerability detections

- Deduplication: Component similarity detection and grouping



$3



- Next.js: App Router, Pages Router, middleware analysis

- React: Components, hooks, JSX patterns

- TypeScript: Full type system analysis

- Modern JavaScript: ES6+, async/await, modules



Usage



$3

bash

sicua





$3



The tool generates a comprehensive JSON report containing:



- Component relationships and dependency graphs

- Complexity metrics for maintainability assessment

- Circular dependency detection with break suggestions

- Zombie cluster identification for unused code cleanup

- SEO optimization recommendations

- Error handling coverage analysis



$3

json

{

  "componentAnalysis": {

    "circularDependencies": [...],

    "zombieClusters": [...],

    "dependencyGraph": [...]

  },

  "complexityMetrics": {

    "cognitiveComplexity": {...},

    "cyclomaticComplexity": {...},

    "maintainabilityIndex": {...}

  },

  "advancedAnalysis": {

    "seoAnalysis": {...},

    "errorHandling": {...},

    "typeAnalysis": {...}

  }

}





Supported File Types



- TypeScript:

.ts, .tsx



- JavaScript:

.js, .jsx



- Configuration:

next.config.js, tsconfig.json

, etc.

- Translation: JSON, TypeScript translation files



Project Structure Analysis



Sicua analyzes:



- Components: React components, hooks, context providers

- Pages/Routes: Next.js pages, API routes, middleware

- Utils/Helpers: Utility functions, shared logic

- Types: TypeScript interfaces, types, enums

- Config Files: Build configuration, environment setup



Requirements



- Node.js: 18.0.0 or higher

- TypeScript projects (JavaScript support included)

- React/Next.js (optimized for these frameworks)



CLI Options

bash

sicua [options]



Options:

  -p, --path               Path to the project (default: current directory)

  -o, --output             Output file path (default: analysis-results.json)

  --src

                    Source directory to analyze

  --root-components       Root component names (comma-separated)

  --extensions             File extensions to process (comma-separated)  

  --verbose                      Enable verbose output

  --force                        Force analysis even if validation fails

  -V, --version                  Show version number

  -h, --help                     Display help information



Additional commands

sicua validate                   # Validate project structure

sicua init                       # Initialize config file  

sicua info                       # Show project information

Additional commands

sicua validate # Validate project structure
sicua init # Initialize config file
sicua info # Show project information

Analysis Categories

$3

- Circular dependency detection
- Component relationship mapping
- Zombie cluster identification
- Import/export tracking

$3

- Cognitive complexity scoring
- Cyclomatic complexity calculation
- Component coupling analysis
- Maintainability index assessment

$3

- Error handling coverage
- SEO optimization opportunities
- Translation completeness
- Code deduplication suggestions

🌐 Full Analysis Platform

Upload your analysis results to sicualabs.com for:

- Interactive dependency graphs
- Detailed recommendations
- AI Multi Model Analysis
- Historical tracking

Contributing

See CONTRIBUTING.md for development setup and contribution guidelines.

License

MIT License - see LICENSE file for details.

Support

- 📚 Documentation
- 🐛 Report Issues
- 💬 Discussions

---

Sicua - Understand your codebase better, ship with confidence.

Installation

bash
npm install -g sicua

Quick Analysis

bash

Analyze current directory

npx sicua

Features

$3

- Component Analysis: Circular dependencies, zombie clusters, component relationships
- Complexity Metrics: Cognitive complexity, cyclomatic complexity, maintainability index
- Dependency Analysis: Unused and missing package dependencies
- Function Analysis: Parameter parsing, async detection, type resolution
- Error Handling: Error boundaries, try-catch blocks, error patterns

$3

- SEO Analysis: Meta tags, structured data, performance optimization
- Translation Coverage: Missing translations, duplicate keys
- Type Analysis: Complex types, duplicate types, usage patterns
- Security Analysis: Basic Security Analysis and vulnerability detections
- Deduplication: Component similarity detection and grouping

$3

- Next.js: App Router, Pages Router, middleware analysis
- React: Components, hooks, JSX patterns
- TypeScript: Full type system analysis
- Modern JavaScript: ES6+, async/await, modules

Usage

$3

bash
sicua

$3

The tool generates a comprehensive JSON report containing:

- Component relationships and dependency graphs
- Complexity metrics for maintainability assessment
- Circular dependency detection with break suggestions
- Zombie cluster identification for unused code cleanup
- SEO optimization recommendations
- Error handling coverage analysis

$3

json
{
"componentAnalysis": {
"circularDependencies": [...],
"zombieClusters": [...],
"dependencyGraph": [...]
},
"complexityMetrics": {
"cognitiveComplexity": {...},
"cyclomaticComplexity": {...},
"maintainabilityIndex": {...}
},
"advancedAnalysis": {
"seoAnalysis": {...},
"errorHandling": {...},
"typeAnalysis": {...}
}
}

Supported File Types

- TypeScript:

- JavaScript:

- Configuration:

, etc.
- Translation: JSON, TypeScript translation files

Project Structure Analysis

Sicua analyzes:

- Components: React components, hooks, context providers
- Pages/Routes: Next.js pages, API routes, middleware
- Utils/Helpers: Utility functions, shared logic
- Types: TypeScript interfaces, types, enums
- Config Files: Build configuration, environment setup

Requirements

- Node.js: 18.0.0 or higher
- TypeScript projects (JavaScript support included)
- React/Next.js (optimized for these frameworks)

CLI Options

bash
sicua [options]

Options:
-p, --path Path to the project (default: current directory)
-o, --output Output file path (default: analysis-results.json)
--src

                    Source directory to analyze

  --root-components       Root component names (comma-separated)

  --extensions             File extensions to process (comma-separated)  

  --verbose                      Enable verbose output

  --force                        Force analysis even if validation fails

  -V, --version                  Show version number

  -h, --help                     Display help information



Additional commands

sicua validate                   # Validate project structure

sicua init                       # Initialize config file  

sicua info                       # Show project information