allframe-forge 0.1.12

AllFrame CLI - Project scaffolding and code generation
Documentation

allframe-forge

AllFrame CLI - Project scaffolding and code generation

Crates.io Documentation License

The AllFrame CLI tool for creating and managing AllFrame projects.

Installation

cargo install allframe-forge

Usage

Create New Project

# Create a new AllFrame project
allframe ignite my-api

# Navigate to the project
cd my-api

# Run the API
cargo run

Project Structure

The generated project includes:

my-api/
├── Cargo.toml
├── src/
│   ├── main.rs           # Application entry point
│   ├── handlers/         # API handlers
│   ├── domain/           # Domain models
│   └── infrastructure/   # Database, config, etc.
├── tests/                # Integration tests
└── examples/             # Usage examples

Features

  • ✅ Clean Architecture - Proper separation of concerns
  • ✅ Protocol-Agnostic - REST, GraphQL, gRPC support
  • ✅ CQRS Ready - Command/Query separation
  • ✅ Test Setup - Pre-configured test infrastructure
  • ✅ Best Practices - Industry-standard project structure

Commands

# Create new project
allframe ignite <name>

# Generate handler
allframe generate handler <name>

# Generate command (CQRS)
allframe generate command <name>

# Generate query (CQRS)
allframe generate query <name>

Project Templates

Minimal

allframe ignite my-api --template minimal
# Simple REST API with basic routing

Full

allframe ignite my-api --template full
# Complete setup with REST, GraphQL, gRPC, and CQRS

CQRS

allframe ignite my-api --template cqrs
# CQRS-focused architecture with event sourcing

Configuration

Generated projects use allframe-core with sensible defaults:

[dependencies]
allframe-core = { version = "0.1", features = [
    "di",
    "openapi",
    "router",
    "otel"
] }

Development

After creating a project:

# Run the API
cargo run

# Run tests
cargo test

# Run with specific features
cargo run --features graphql,grpc

# View API documentation
# Visit http://localhost:8080/docs after starting

Examples

See the examples/ directory in the AllFrame repository for complete project examples.

License

Licensed under either of:

at your option.

Resources