awesome-smithy

Awesome Smithy is a curated list of awesome build-tools, code-generators, examples, and other resources related to the Smithy IDL.
https://github.com/smithy-lang/awesome-smithy

Last synced: 6 days ago
JSON representation

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](https://dafny.org/) 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](https://dafny.org/) 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](https://github.com/nvim-treesitter/nvim-treesitter) and [Helix](https://docs.helix-editor.com/) by default.
  - Zed extension - [Zed](https://zed.dev/) extension using [Tree-sitter grammar for Smithy](https://github.com/indoorvivants/tree-sitter-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](https://aws.amazon.com/blogs/devops/smithy-server-and-client-generator-for-typescript/)).
  - 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](https://www.openapis.org/).
  - Smithy to JSONSchema - favicon.png" alt="(official)" title="Smithy Official" height="16px"> - Converts Smithy models to [JSONSchema](https://json-schema.org/).
  - 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](https://json-schema.org/).
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.

Programming Languages

Java 8 Scala 8 TypeScript 3 Rust 2 Smithy 2 C# 1 Common Lisp 1 Scheme 1 JavaScript 1 Kotlin 1

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

awesome-smithy

Blog Posts

GitHub Actions

Build tools

CICD Support

GitHub Actions

Code Generators

Client Code Generators

Server Code Generators

IDE Support

Server Code Generators

Implementations

Server Code Generators

Learning resources

Server Code Generators

Model Converters

Server Code Generators

Others

GitHub Actions

Videos

GitHub Actions