The default profile composes the Vireo React application with a Spring Boot backend, Flyway migrations and either embedded H2 development storage or PostgreSQL.
Create the application#
npm create vireo@latest operations-app
cd operations-app
corepack npm run setup
corepack npm run doctor
corepack npm run devThe development command starts the backend on port 8080 and the frontend on port 3000. The frontend development server proxies API traffic to Spring Boot.
Database choice#
H2 is the lowest-friction evaluation path and requires no container. PostgreSQL is the production-shaped option and requires Docker Compose for the generated local environment.
The selected database is recorded in .vireo/project.json; Doctor validates the corresponding prerequisites.
Generate a coordinated slice#
corepack npm run vireo -- generate entity .vireo/examples/purchase-order.entity.json
corepack npm run generate:check
corepack npm run verifyThe generator produces a reviewed frontend transport and UI together with the Spring DTO, controller, service, persistence and migration boundaries. It does not invent business policy.
Preserve the application boundary#
Vireo-managed files may be regenerated when their schema remains authoritative. Product rules, authorization policy, integrations and special transaction behavior belong in application-owned code. Use Generated code ownership before customizing generated output.
Continue with Architecture or the 30-minute vertical slice.