Guide

Learn how to use facet for serialization, deserialization, and rich diagnostics.

Start here

• First run: Getting Started — install → derive → round-trip → errors.
• Decide if facet fits: Why facet? — tradeoffs vs serde.
• See it in action: Showcases.

Guides

• Getting Started
• Why facet?
• Attributes Reference — complete #[facet(...)] catalog
• Dynamic Values — Value, assert_same!, RawJson
• Errors & diagnostics
• Variance and Soundness — lifetime safety in reflection
• Comparison with serde
• FAQ — common questions and quick answers

Reference (quick links)

• Format comparison matrix — feature support across format crates
• Extension Attributes — namespaced attributes by crate

Ecosystem

• Third-party types — uuid, chrono, time, camino, bytes, and more
• structstruck — generate structs from sample data