# Sylius Upgrade Analyzer

## What it is
Sylius Upgrade Analyzer is a web service that generates detailed PDF migration reports for upgrading Sylius e-commerce from version 1.x to 2.x. It analyzes your composer.json to identify breaking changes, bundle compatibility issues, and produces a step-by-step migration plan with hour estimates.

## Key facts
- Analyzes Sylius 1.x composer.json files (versions 1.9 to 1.13)
- Generates comprehensive PDF migration reports
- Detects breaking changes for Sylius 2.0
- Checks third-party bundle and plugin compatibility
- Provides step-by-step migration action plans with hour estimates
- Includes risk scoring and roadmap per component
- Three pricing tiers: Report (59 EUR one-time), Studio (299 EUR/year), Agency (799 EUR/year)
- White-label PDF support for agencies (Studio and Agency plans)
- CLI tool installable via Composer for local code analysis
- Backend: Symfony 7 / PHP 8.3
- Frontend: React 19 + TypeScript + Vite
- Hosted: Fly.io (Paris, France) + Vercel
- GDPR compliant: no cookies, no trackers, PDFs deleted after 24h
- Created by Pierre-Arthur Demengel

## How it works
1. User uploads their Sylius 1.x composer.json (web interface) or runs the CLI tool locally
2. The tool analyzes dependencies against Sylius 2.x requirements
3. A detailed PDF report is generated with:
   - Executive summary with global complexity level
   - Dependency compatibility matrix
   - Breaking changes specific to the project, categorized (Twig templates, API, Doctrine entities, configuration, events)
   - Hour estimates per issue and per category
   - Quick wins to prioritize
   - Global risk score
   - Step-by-step migration roadmap
   - Validation checklist

## Pricing
- **Report** (59 EUR, one-time): 1 PDF report, ideal for a one-time migration audit
- **Studio** (299 EUR/year): 10 PDFs/day, white-label (logo + colors), report history, email support
- **Agency** (799 EUR/year): Unlimited PDFs, full white-label, CSV export, multi-project PDF, before/after comparison, webhook notifications, budget estimation with daily rate, priority support

## API
- POST /v1/analyze — Free partial analysis of a composer.json (returns detected version, plugins, deprecated packages)
- POST /v1/reports — Generate full PDF report (requires API key)
- GET /v1/reports/{id}/download — Download generated PDF
- GET /v1/reports/history — Get report history (Studio/Agency)
- GET /v1/reports/{id}/csv — Export issues as CSV (Agency)
- POST /v1/reports/compare — Compare two reports (Agency)
- POST /v1/reports/multi — Generate multi-project PDF (Agency)

## CLI Installation
```
composer require --dev pierrearthur/sylius-upgrade-analyzer
vendor/bin/sylius-upgrade-analyzer analyze --api-key=YOUR_KEY --send
```

## Supported Sylius versions
- Source: Sylius 1.9, 1.10, 1.11, 1.12, 1.13
- Target: Sylius 2.0

## Documentation
- Migration guide: https://sylius-upgrade-analyzer.dev/docs/migration-guide
- Breaking changes: https://sylius-upgrade-analyzer.dev/docs/breaking-changes
- API reference: https://sylius-upgrade-analyzer.dev/docs/api
- Tutorial: https://sylius-upgrade-analyzer.dev/docs/tutorial
- Changelog Sylius 2.0: https://sylius-upgrade-analyzer.dev/docs/changelog-sylius-2
- Glossary: https://sylius-upgrade-analyzer.dev/docs/glossary
- FAQ: https://sylius-upgrade-analyzer.dev/faq
- OpenAPI spec: https://sylius-upgrade-analyzer.dev/.well-known/openapi.yaml
- Full documentation for LLMs: https://sylius-upgrade-analyzer.dev/llms-full.txt

## Contact
- Website: https://sylius-upgrade-analyzer.dev
- Email: pierrearthur.demengel@gmail.com
- GitHub: https://github.com/pierrearthurdemengel/sylius-upgrade-analyzer