examples

Firebird Examples

Run any example with mix run examples/<name>.exs

Start Here

Example	Description
quick_start.exs	Start here — Complete tour of all DX features
thirty_seconds.exs	Firebird in 30 seconds
basic_usage.exs	Simple load → call → stop
firebird_livebook.livemd	Interactive Livebook notebook
firebird.livemd	Compact Livebook notebook

Testing

Example	Description
testing_wasm.exs	All 10 testing patterns — TestCase, table-driven tests, exports, types, errors, performance

Performance & Observability

Example	Description
profiling_and_metrics.exs	Profiling, metrics, throughput — Profiler, Metrics, WASM vs Elixir comparison

Patterns & Integration

Example	Description
module_wrapper.exs	Declarative module wrapping with use Firebird
supervision_tree.exs	Using Firebird.Module and Pool in a supervision tree
concurrent_pool.exs	High-concurrency pool usage with benchmarks
pool_usage.exs	Pool basics and configuration
pipeline_and_batch.exs	Pipeline (chain calls with |>) + Batch (parallel execution with stats)
stream_processing.exs	Lazy stream pipelines with Firebird.Stream — map, filter, reduce over WASM
error_handling.exs	Error handling patterns and best practices
new_features.exs	New DX features: use Firebird, wat!(), Quick module

Memory & Data Exchange

Example	Description
memory_management.exs	Structured memory — strings, typed arrays, struct layouts, arenas, secure free

Language Integration

Example	Description
string_processing.exs	Passing strings to/from WASM with WasmString
string_utils_demo.exs	String utilities demo
go_math_demo.exs	Using Go-compiled WASM modules
build_and_run.exs	Complete Go → WASM → Elixir workflow

Elixir-to-WASM Compilation

Example	Description
compile_to_wasm.exs	Compile Elixir modules to WebAssembly

Phoenix Integration

Example	Description
phoenix_wasm_demo.exs	All Phoenix WASM components working together
phoenix_wasm_app.exs	REST API using Firebird's Phoenix components
phoenix_wasm_full_app.exs	Full Phoenix WASM application with all components
phoenix_wasm_server.exs	Phoenix-style WASM HTTP server

End-to-End Demos

Example	Description
end_to_end_demo.exs	End-to-end Firebird demo
end_to_end_wasm_demo.exs	End-to-end WASM with Go & Rust
comprehensive_demo.exs	Comprehensive feature demo

Complete Projects

Example	Description
complete_project/	Full Elixir project with Firebird — mix.exs, supervision tree, tests
complete_wasm_demo/	End-to-end WASM demo project

Language-Specific WASM Guides

Step-by-step guides for compiling different languages to WASM for use with Firebird:

Example	Description
rust_math/	Rust → WASM math module with build instructions
rust_to_wasm/	General Rust → WASM compilation guide
go_math/	Go → WASM math module with build instructions
go_to_wasm/	General Go → WASM compilation guide
go_wasi/	Go WASI module guide
wat_math/	Hand-written WAT (WebAssembly Text) module