Getting Started

Sicua is 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.

Installation


npx sicua

Quick Start

Navigate to your project


cd your-nextjs-project

Run the analysis


npx sicua

Upload results to platform

Visit sicualabs.com and upload your analysis-results.json

Generated Output

After analysis, you’ll find this structure in your project:

- analysis-results.json
- package.json
- next.config.js

CLI Options

Option	Description	Default
`-p, --path <path>`	Project path to analyze	Current directory
`-o, --output <path>`	Output file location	`analysis-results.json`
`--src <dir>`	Source directory	Auto-detected
`--verbose`	Enable detailed logging	`false`
`--force`	Force analysis on validation errors	`false`

Additional Commands


sicua validate

Validates your project structure before running analysis


sicua init

Creates a configuration file for custom analysis settings


sicua info

Shows project information and framework compatibility

Requirements

System Requirements

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