Skip to content

Cargo Feature Flags

Cargo features choose code at compile time. Runtime plugin selection chooses among components already compiled into the binary. Neither action creates AWS resources.

Default Surface

toml
[dependencies]
minco = "1.0.0"

The default enables contract, http, and default-plugins. The default plugin bundle contains health, observability, and idempotency.

Framework Planes

FeatureEnables
configstrict typed configuration graph
dbprovider-neutral database lifecycle contracts
contractOpenAPI validation, indexing, and compatibility
httpresource shapes and Axum/Tower conventions
planPlan IR and contract-aware deployment planning
releaseexact artifact and release manifests
testpublic test and plugin conformance helpers

Plugins

FeatureComponentDefault
plugin-healthliveness, readiness, dependency healthyes
plugin-observabilitystructured tracing and CloudWatch-compatible logsyes
plugin-idempotencykeys, fingerprints, and a storage portyes
plugin-sessionssession issuance, lookup, expiry, revocationno
plugin-identityverified claims, identities, scopes, permissionsno
plugin-object-storageuploads, exports, attachmentsno
plugin-eventsdomain events and transactional-outbox portsno
plugin-notificationsemail, webhook, in-app, developer channelsno
plugin-auditappend-only audit historyno
plugin-feedbackclient review loop and AI handoffno
plugin-static-siteprivate assets and CDN deployment intentno
plugin-realtimeephemeral backend publication and subscriber-only browser invalidationno

plugin-feedback also enables the plugin capabilities it composes: health, identity, object storage, events, notifications, audit, and HTTP.

Adapters and Runtimes

FeatureComponent
sqlx-postgresPostgreSQL pool and explicit migration adapter
sqlx-sqliteSQLite adapter with explicit durability constraints
aws-adaptersopt-in S3, SQS, SSM, and related provider adapters
aws-dynamodbvalidated DynamoDB client, table intent, and readiness boundary
aws-lambdanative Lambda HTTP runtime and SSM configuration loading
aws-workerSQS Lambda partial-batch worker runtime

Bundles

official-plugins enables all official plugins. full additionally enables every framework plane, all three database adapters, and all AWS runtimes and adapters. Use full for framework qualification; application binaries should normally pick the smaller explicit set they operate.

toml
[dependencies]
minco = { version = "1.0.0", features = [
  "config",
  "plan",
  "release",
  "test",
  "sqlx-postgres",
  "aws-lambda",
  "plugin-identity",
  "plugin-sessions",
] }

The generated authority is docs/reference/generated/features.md. It is derived from crates/minco/Cargo.toml and checked byte-for-byte in the repository quality gate.

Minimal cost, maximum capability.