Spikard — Part of the spikard polyglot web toolkit.
Codegen-first polyglot web toolkit on a Rust core: OpenAPI/AsyncAPI/GraphQL/JSON-RPC/gRPC codegen, SQL-to-HTTP, tower-http middleware, and an MCP server. Experimental, pre-1.0. Elixir bindings via Rustler NIF with OTP integration.
Install · Quick example · Features · Docs
Important
spikard is experimental and pre-1.0. APIs change between releases and not every binding is at the same level of maturity, so it is not yet recommended for production. Feedback is genuinely wanted at this stage — open an issue if something is wrong, awkward, or missing.
What this package provides
OTP-integrated Rustler bindings — Elixir 1.14+ with Erlang 25+ for distributed systems
Type-safe routing — HTTP definitions with path, query, body, and header validation across all bindings
Spec-driven codegen — OpenAPI 3.0, AsyncAPI 3.0, GraphQL SDL, and JSON-RPC 2.0 support
Cross-language parity — same DTOs, fixtures, and error model prevent runtime drift
Tower middleware — compression, rate limiting, timeouts, auth (JWT/API key), static files
Lifecycle hooks —
onRequest,preValidation,preHandler,onResponse,onError
Installation
Add to mix.exs:
def deps do
[
{:spikard, "~> 0.17.0-rc.11"}
]
end
Run mix deps.get.
System Requirements
- Elixir 1.14+ and Erlang/OTP 25+ required
Quick example
See the spikard repository for usage examples and guides.
Features
| Feature | Support |
|---|---|
| Type-safe routing | Path, query, body, and header parameter validation |
| Request extraction | Typed structs for JSON, form data, multipart, and raw bodies |
| Spec support | OpenAPI 3.0 · AsyncAPI 3.0 · GraphQL SDL · JSON-RPC 2.0 |
| Middleware | Compression, rate limiting, timeouts, authentication, static files |
| Lifecycle hooks | Request, pre-validation, pre-handler, response, and error hooks |
| WebSocket & SSE | Bidirectional streams and server-sent events |
| Error handling | Consistent error responses across all bindings via ProblemDetails |
| Fixture testing | Shared JSON fixtures for behavioral consistency across languages |
Routing
See examples in the repository.
Validation
See examples in the repository.
Middleware & configuration
See examples in the repository.
Resources
- Repository — source code, examples, and issues
- Examples — working implementations in all supported languages
- Contributing — how to contribute
License
MIT License — see LICENSE for details.