smithy-exercises

Learn Smithy by writing it.

Short, focused lessons on the Smithy IDL — each ending with a hands-on exercise you write in the browser and check against the real Smithy compiler. Diagnostics come straight from the model assembler, inline.

Lessons

  1. 01 What is Smithy? A model-first, protocol-agnostic IDL for describing services once and generating everywhere. →
  2. 02 Simple shapes Strings, numbers, booleans, timestamps, blobs — and how to name your own. →
  3. 03 Structures Records with typed members — the shape you'll reach for most. →
  4. 04 Lists & maps Aggregate collections — ordered lists and string-keyed maps (and where set went). →
  5. 05 Unions Tagged unions — a value that is exactly one of several named variants. →
  6. 06 Traits Typed annotations that add docs and constraints without changing the type. →
  7. 07 Services & operations Describe an API — a service of operations, each with input, output, and HTTP bindings. →
  8. 08 Resources Model entities with identity and bind lifecycle operations to them. →
  9. 09 Errors Model failures as structures and attach them to operations. →
  10. 10 Capstone: the Weather service Put it all together — model Smithy's canonical Weather service end to end. →