Home Domain Milestones Documents Presentations About Contact
project.fractalx.org  ·  Open Source  ·  Apache 2.0

Monolith to Microservices,
One Command

FractalX is an open-source static decomposition framework that converts modular Spring Boot monoliths into production-ready microservice platforms — via AST analysis and build-time code generation. No runtime agent. No manual wiring.

Explore the Domain View Documents fractalx.org
fractalx decompose
$mvn fractalx:decompose
[INFO] FractalX v0.4.1 — Static Decomposition Engine
[INFO] Scanning modules: order, payment, inventory...
[INFO] AST analysis complete — 3 modules detected
[SUCCESS] order-service generated (:8081)
[SUCCESS] payment-service generated (:8082)
[SUCCESS] inventory-service generated (:8083)
[SUCCESS] fractalx-gateway generated (:9999)
[SUCCESS] fractalx-admin generated (:9090)
[SUCCESS] docker-compose.yml + start-all.sh ready
$
3
Annotations Required
1
Maven Command
6+
Auto-Generated Services
0
Manual Wiring Needed
Project Overview

What is FractalX?

FractalX addresses one of the most expensive and error-prone challenges in modern software engineering — migrating monolithic applications to microservices. Through static code analysis and automated generation, it eliminates weeks of boilerplate work.

Static AST Analysis
Reads your monolith source code at build-time using Abstract Syntax Tree analysis. No runtime agent, no bytecode manipulation — pure static decomposition.
Full Microservice Generation
Produces complete, independently deployable microservices — each with its own pom.xml, Dockerfile, application.yml, and database isolation.
NetScope gRPC Fabric
Auto-generates type-safe gRPC client interfaces for inter-service communication. Cross-module calls become strongly-typed, resilient, and traced automatically.
Distributed Saga Orchestration
Annotate a method with @DistributedSaga and FractalX generates a full saga orchestrator service with compensation and rollback logic.
Admin Dashboard
A 15-section operational dashboard is auto-generated per deployment, covering service health, circuit breakers, saga state machines, and distributed traces.
Docker-Ready Deployment
Every generated service includes a production-ready Dockerfile. A unified docker-compose.yml and start-all.sh script is generated for the entire platform.
Workflow

How It Works

Three steps from monolith to a fully wired microservice platform.

01
Annotate Your Monolith
Add three annotations to declare module boundaries. No other source changes required — your monolith continues to run normally.
@DecomposableModule
@DistributedSaga
@ServiceBoundary
02
Run One Command
The FractalX Maven plugin performs AST analysis, resolves cross-module dependencies, and generates all output into a separate directory.
$ mvn fractalx:decompose
03
Get a Full Platform
Receive production-ready microservices, an API gateway, service registry, admin dashboard, saga orchestrator, logger service, and Docker infrastructure.
✓ fractalx-output/
  ✓ order-service/
  ✓ fractalx-gateway/
  ✓ docker-compose.yml
Generated Platform

Everything Generated For You

FractalX produces a complete microservice platform — not just the business services, but the entire surrounding infrastructure.

:808x
Business Services
One per @DecomposableModule
:9999
API Gateway
Routes, auth, rate limiting, CORS
:8761
Service Registry
Lightweight service discovery
:9090
Admin Dashboard
15-section ops UI
:8099
Saga Orchestrator
Distributed transactions + rollback
:9099
Logger Service
Centralised structured logging
Explore the Project

Dive into the Research

Explore the full research domain, project milestones, technical documents, and presentations that chronicle the journey of building FractalX.

Research Domain View Milestones Meet the Team