arcature 2026.2.1

Arcature application framework: a high-level Application facade over the certified Arcature subsystems, with the low-level Axum/Tower escape hatch preserved.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82

# arcature

`arcature` is the high-level Application facade over the certified Arcature
subsystems. It assembles the HTTP kernel (Axum/Tower), Inertia adapter,
database, cache, storage, mail, jobs, auth, pages, and observability into a
single `Application` builder — while preserving the raw Axum/Tower escape
hatch for expert use.

## What this crate owns

The `Application` builder, the request lifecycle (startup → serve → shutdown),
the pipeline assembly, the `Resources` container (typed subsystem handles),
and the `#[arcature::main]` runtime macro.

## What this crate does not own

It does not reimplement any subsystem. Each subsystem lives in its own
crate (`arcature-db`, `arcature-cache`, etc.) and is optional behind a
feature flag. The facade wires them together; it does not replace them.

## Quick start

```rust,no_run
use arcature::prelude::*;

fn main() -> std::io::Result<()> {
    Application::new()
        .port(3000)
        .routes(routes())
        .build()
        .run()
}

fn routes() -> Routes<()> {
    Routes::new().route("/", get(|| async { "Hello, Arcature!" }))
}
```

With subsystems (feature flags):

```rust,no_run
use arcature::prelude::*;
use arcature::db::DbConfig;

async fn run() -> Result<()> {
    Application::new()
        .port(3000)
        .database(DbConfig::new("postgres://localhost/myapp")?)
        .build()
        .run_with_lifecycle(|resources| {
            // Access the live Db handle via resources.db()
        })
        .await
}
```

## Feature flags

| Feature | Subsystem |
|---------|-----------|
| `macros` | `#[arcature::main]` |
| `inertia` | Inertia.js server adapter |
| `db` | PostgreSQL |
| `auth` | Session auth, Argon2id, CSRF, OAuth |
| `cache` | Valkey/Redis cache |
| `storage` | Object/file storage |
| `mail` | Email (SMTP) |
| `jobs` | Background jobs |
| `pages` | Special pages + maintenance |
| `api` | OpenAPI 3.1 + problem details |
| `observe` | Tracing/metrics + OpenTelemetry |

## Documentation

- [Architecture](../../docs/ARCHITECTURE.md) — locked stack and innovation areas
- [Security model](../../docs/SECURITY_MODEL.md) — security baseline
- [Performance](../../docs/PERFORMANCE.md) — performance constitution
- [Dogfood app](../../dogfood/linkhub/) — LinkHub reference application

## License

Apache License 2.0 (see workspace `LICENSE`).