How superealabs/genesis works
Genesis is a database-first project generator exposed through a CLI and JetBrains integration. A user selects language, framework, database entities, and output options; Genesis introspects the schema, builds generation context, renders backend and frontend templates, then writes or merges a runnable project. Separate paths support AI-generated SQL, rule-to-code generation, and synchronization reports. The tree and excerpts establish the main orchestration and metadata flow; several generator-to-output links are documented capabilities rather than fully sampled implementations.
Main entry points: Database.java Database Access · ProjectGenerator.java Project Generator · ProjectGeneratorHandler.java Project Handler · GenerationContextManager.java IDE Context
Components 22
Entry Points
- CLI Entry
genesis-cli/src/main/java/org/labs/GenesisCLI.java - Project Handler
genesis-cli/src/main/java/org/labs/handler/ProjectGeneratorHandler.java - IDE Context
genesis-intellij/src/main/java/org/labs/genesis/context/GenerationContextManager.java
Schema and Context
- Generation Context
genesis-core/src/main/java/org/labs/genesis/config/ProjectGenerationContext.java - Database Access
genesis-core/src/main/java/org/labs/genesis/connexion/Database.java - Schema Metadata
genesis-core/src/main/java/org/labs/genesis/connexion/model/TableMetadata.java
Code Generation
- Project Generator
genesis-core/src/main/java/org/labs/genesis/config/langage/generator/project/ProjectGenerator.java - Backend Generator
genesis-core/src/main/java/org/labs/genesis/config/langage/generator/framework/GenesisGenerator.java - Template Loader
genesis-core/src/main/java/org/labs/genesis/config/langage/generator/framework/FrameworkTemplateLoader.java - Template Engine
genesis-core/src/main/java/org/labs/genesis/engine/GenesisTemplateEngine.java - Frontend Generator
genesis-core/src/main/java/org/labs/genesis/frontend/generator/FontendGenerator.java - Generated Backend
- Generated Frontend
- Project Merge
genesis-core/src/main/java/org/labs/genesis/merge/MergeTool.java
Sync and Integration
- Sync Generator
genesis-core/src/main/java/org/labs/genesis/config/langage/generator/sync/SyncGenerator.java - Schema Evaluators
genesis-core/src/main/java/org/labs/genesis/config/langage/generator/sync/evaluators/DatabaseEvaluatorsManager.java - Change Reports
genesis-core/src/main/java/org/labs/genesis/config/langage/generator/sync/report/DatabaseReportManager.java - AI SQL Client
genesis-core/src/main/java/org/labs/genesis/config/langage/generator/project/LlmApiClient.java - Rule Code AI
genesis-core/src/main/java/org/labs/genesis/config/langage/generator/ruleToCode/LlmApiClientRule.java
Other components
- Developer
- Source Database
- LLM Service
Connections 23
- Developer → CLI Entry: starts generation
- Developer → IDE Context: starts generation
- CLI Entry → Project Handler: dispatches to
- Project Handler → Generation Context: builds context
- IDE Context → Generation Context: selects mode
- Project Handler → Database Access: reads schema
- Database Access → Source Database: queries metadata
- Database Access → Schema Metadata: creates metadata
- Project Generator → Database Access: loads entities
- Project Generator → Backend Generator: dispatches backend
- Backend Generator → Template Loader: loads templates
- Backend Generator → Template Engine: renders code
- Template Engine → Generated Backend: produces files
- Project Generator → Frontend Generator: dispatches frontend
- Frontend Generator → Generated Frontend: produces files
- Project Generator → Project Merge: writes project
- IDE Context → Sync Generator: selects sync
- Sync Generator → Database Access: loads schema
- Sync Generator → Schema Evaluators: evaluates changes
- Schema Evaluators → Change Reports: records changes
- AI SQL Client → Database Access: reads schema
- AI SQL Client → LLM Service: generates SQL
- Rule Code AI → LLM Service: generates code