Blog Posts

GitHub Actions

• Introducing Smithy IDL 2.0 - anvil.svg" alt="(official)" title="Smithy Official" height="10px"> - Launch announcement for the Smithy IDL 2.0.
• Introducing the Smithy CLI - anvil.svg" alt="(official)" title="Smithy Official" height="10px"> - Launch announcement for the Smithy CLI along with examples of how to use the CLI.
• Developer Preview: Ruby SDK code generation using Smithy - anvil.svg" alt="(official)" title="Smithy Official" height="10px"> - Launch announcement for and overview of the AWS Ruby SDK built with Smithy.
• Smithy4s-full stack - A series of posts describing an application built with Smithy4s in both front-end and back-end.
• Introducing AWS API models and publicly available resources for AWS API definitions - Launch announcement for AWS's API models being published as Smithy specs in Maven Central.
• Generate standalone types with Smithy - anvil.svg" alt="(official)" title="Smithy Official" height="10px"> - Launch announcement of Smithy's shape closures, a named set of shapes you declare in the model yourself, used to generate standalone types outside a service model.

Build tools

• Smithy CLI - anvil.svg" alt="(official)" title="Smithy Official" height="10px"> - Smithy CLI is used to build, validate, diff, and transform Smithy models.
• SBT Plugin - Community supported plugin that integrates smithy with the SBT build system for Scala.
• Gradle Plugin - anvil.svg" alt="(official)" title="Smithy Official" height="10px"> - Integrates Smithy with the Gradle build system.
• Smithy Cargo - Community supported build tool that integrates smithy with Cargo build scripts (build.rs)

CICD Support

GitHub Actions

• setup-smithy - Install Smithy CLI to your GitHub Workflow.
• format-smithy - Checks if Smithy Models are formatted.
• setup-smithy-cli - anvil.svg" alt="(official)" title="Smithy Official" height="10px"> - Install the Smithy CLI for a GitHub action to validate, build, format, and diff Smithy models in a GitHub repository.

Code Generators

Client Code Generators

• Golang - anvil.svg" alt="(official)" title="Smithy Official" height="10px"> 🚧 - Client code generation for Golang.
• Swift - favicon.png" alt="(official)" title="Smithy Official" height="16px"> 🚧 - Client code generation for Swift.
• Dafny - favicon.png" alt="(official)" title="Smithy Official" height="16px"> 🚧 - Code generation tools for the Dafny verification-aware programming language.
• Python - anvil.svg" alt="(official)" title="Smithy Official" height="10px"> 🚧 - Client code generation for Python.
• Ruby - anvil.svg" alt="(official)" title="Smithy Official" height="10px"> 🚧 - Client code generation for Ruby.
• Kotlin - anvil.svg" alt="(official)" title="Smithy Official" height="10px"> 🚧 - Client code generation for Kotlin.
• Swift - anvil.svg" alt="(official)" title="Smithy Official" height="10px"> 🚧 - Client code generation for Swift.
• Dafny - anvil.svg" alt="(official)" title="Smithy Official" height="10px"> 🚧 - Code generation tools for the Dafny verification-aware programming language.
• Erlang, Elixir, Gleam - Community plugin for generating clients and servers targeting BEAM languages: Erlang, Elixir, Gleam
• C# - Community plugin for generation of clients/servers in C#.

Server Code Generators

• TypeScript - favicon.png" alt="(official)" title="Smithy Official" height="16px"> 🚧 - Server generator for TypeScript.
• Scala - Community plugin for generation of clients/servers in Scala.
• Java - anvil.svg" alt="(official)" title="Smithy Official" height="10px"> 🚧 - Server code generation for Java.
• TypeScript - anvil.svg" alt="(official)" title="Smithy Official" height="10px"> 🚧 - Server generator for TypeScript.
• Rust - anvil.svg" alt="(official)" title="Smithy Official" height="10px"> 🚧 - Server generator for Rust.

IDE Support

Server Code Generators

• Smithy LSP - favicon.png" alt="(official)" title="Smithy Official" height="16px"> 🚧 - A Language Server Protocol implementation for the Smithy IDL.
• Visual Studio Code Plugin - favicon.png" alt="(official)" title="Smithy Official" height="16px"> 🚧 - Visual Studio Code extension providing a Language Server Protocol implementation for the Smithy IDL.
• Intellij plugin - anvil.svg" alt="(official)" title="Smithy Official" height="10px"> 🚧 - Provides IDE integration for the Smithy IDL within IntelliJ IDEA.
• iancaffey/smithy-intellij-plugin - Community plugin for IDE integration for the Smithy IDL in Intellij IDEA.
• Tree Sitter Grammar for Smithy - Tree-sitter grammar for Smithy. Included in Neovim and Helix by default.
• Zed extension - Zed extension using Tree-sitter grammar for Smithy.
• Smithy LSP - anvil.svg" alt="(official)" title="Smithy Official" height="10px"> 🚧 - A Language Server Protocol implementation for the Smithy IDL.
• Visual Studio Code Plugin - anvil.svg" alt="(official)" title="Smithy Official" height="10px"> 🚧 - Visual Studio Code extension providing a Language Server Protocol implementation for the Smithy IDL.

Implementations

Server Code Generators

• Atelier - Community implementation of Smithy in Rust
• Smithy Reference Implementation - anvil.svg" alt="(official)" title="Smithy Official" height="10px"> - Smithy reference implementation in Java
• smithy-lisp

Learning resources

Server Code Generators

• Rust server SDK examples - favicon.png" alt="(official)" title="Smithy Official" height="16px"> - a collection of examples using Smithy to generate a Rust server SDK.
• Smithy Examples - anvil.svg" alt="(official)" title="Smithy Official" height="10px"> - A collection of examples to help you get up and running with Smithy.
• aws-samples: Typescript Example service - anvil.svg" alt="(official)" title="Smithy Official" height="10px"> - Shows how to write a Typescript lambda service using Smithy and call the service using a generated client (see: blog post).
• kubukoz/smithy4s-course - Smithy/Smithy4s course.
• Rust server SDK examples - anvil.svg" alt="(official)" title="Smithy Official" height="10px"> - a collection of examples using Smithy to generate a Rust server SDK.

Model Converters

Server Code Generators

• Smithy to OpenAPI - anvil.svg" alt="(official)" title="Smithy Official" height="10px"> - Converts Smithy models to OpenAPI.
• Smithy to JSONSchema - favicon.png" alt="(official)" title="Smithy Official" height="16px"> - Converts Smithy models to JSONSchema.
• Cloud Formation Resource Schemas - anvil.svg" alt="(official)" title="Smithy Official" height="10px"> - Generating Cloudformation resource schemas from Smithy models.
• Smithy to Protobuf - smithy-translate (see above)
• Smithy to JSONSchema - anvil.svg" alt="(official)" title="Smithy Official" height="10px"> - Converts Smithy models to JSONSchema.

Others

GitHub Actions

• Smithy Playground - A language server and VS Code client for interactive experimentation with Smithy services.
• Build Server Protocol - an extension to the Language Server Protocol using Smithy as a definition language.
• Alloy - a library of Smithy traits providing additional semantics and constraints, used in particular by smithy-translate and smithy4s.
• smaws - a Smithy generator and AWS SDK built in OCaml
• Smithy Selector Playground - a web tool for experimenting with Smithy selectors
• Smithy Transcoder - a web tool for previewing the serialized form of Smithy models
• Smithy Playground - A language server and VS Code client for interactive experimentation with Smithy services.
• Alloy - a library of Smithy traits providing additional semantics and constraints, used in particular by smithy-translate and smithy4s.
• smaws - a Smithy generator and AWS SDK built in OCaml
• Smithy Selector Playground - a web tool for experimenting with Smithy selectors

Videos

GitHub Actions

• Scaling APIs with Smithy - anvil.svg" alt="(official)" title="Smithy Official" height="10px"> - Overview of Smithy's background and features.
• Abstraction: Creating the Best developer experience / Model-First Design - favicon.png" alt="(official)" title="Smithy Official" height="16px"> - An introduction to model first design with Smithy.
• Building with the new AWS SDKs for Rust, Kotlin, and Swift - anvil.svg" alt="(official)" title="Smithy Official" height="10px"> - Explores how these SDKs were built in parallel with Smithy, the commonalities they share, and how to build an app with each one.
• Simplify building applications with AWS SDKs - anvil.svg" alt="(official)" title="Smithy Official" height="10px"> - Discusses how Smithy and model-first API design are used at AWS, how the AWS SDKs model client-side primitives such as paginators in Smithy, and how the AWS SDKs are evolving to use a standardized architecture.
• Introduction to Smithy/Smithy4s - Scala Conference talk introducing the Smithy IDL and the Smithy4s library
• Generating Kotlin SDKs with Smithy - KotlinConf talk that provides an overview of Smithy and discusses how smithy-kotlin can be used to generate Kotlin SDKs
• Elevating API Design With Smithy - Functional Scala talk - Intro to Smithy IDL with JVM Tooling and Smithy4s
• Abstraction: Creating the Best developer experience / Model-First Design - anvil.svg" alt="(official)" title="Smithy Official" height="10px"> - An introduction to model first design with Smithy.