Create a New Spring Boot Project
Use arconia create to scaffold a new Spring Boot project from a template.
Templates are pre-configured project structures distributed as OCI artifacts.
Create a project
arconia create --name my-app --template server-http
Both --name and --template are required.
Common options
| Option | Default | Description |
|---|---|---|
--name |
(required) | Project name (used as directory name and artifact ID) |
--template |
(required) | Template alias or full OCI reference |
--group |
com.example |
Group ID (e.g., io.arconia) |
--description |
Project description | |
--package-name |
Java package name (defaults from group + name) | |
--path |
current directory | Where to create the project |
Example with all options
arconia create \
--name my-app \
--template server-http \
--group io.arconia \
--description "My web application" \
--package-name io.arconia.app
Discover available templates
List all templates from registered catalogs:
arconia template list
List templates from a specific catalog:
arconia template list --name arconia-project-templates
Template references
Templates can be specified as:
- Alias (short name):
server-http— resolved from a registered template catalog - Full OCI reference:
ghcr.io/arconia-io/arconia-templates/server-http— fetched directly
Use aliases when available (shorter, easier to remember). Use full OCI references when the template is not in a registered catalog.
Workflow
- Discover templates:
arconia template list - Pick a template that matches the project requirements
- Create the project:
arconia create --name my-app --template <template> - Navigate into the project:
cd my-app - Start developing:
arconia dev
Gotchas
- Template aliases only work if a catalog containing them is registered. If an alias is not found, use the full OCI reference instead.
- The
--groupdefaults tocom.example. Set it to the actual organization group ID (e.g.,io.arconia) for real projects. - The project is created in a subdirectory named after
--nameinside the--pathdirectory (defaults to the current directory).