README.md

Awesome TypeSpec

A curated list of awesome resources for learning and working with TypeSpec, a powerful language for modeling and generating API contracts.

What is TypeSpec?

TypeSpec is a language designed for creating precise API specifications. It helps developers define data models and API endpoints, ensuring consistent contract generation and seamless integration across platforms. TypeSpec is particularly useful for teams building large-scale APIs or microservices architectures.

Contents

• Official Resources
• Articles & Tutorials
• • Client generation
• Videos & Talks
• Contributing

Official Resources

• TypeSpec Documentation
• TypeSpec GitHub Repository

Client generation tutorials

• C#
• Python
• Java
• JavaScript

Emitters (generators)

• OpenApi3 - Emitter for OpenApi
• JSON Schema - Emitter for JSON Schema
• Protobuf Emitter for Protobuf
• Postgres - This unofficial Library for TypeSpec makes it possible to emit the models defined in TypeSpec to PostgreSQL.
• C# client generator – The official TypeSpec C# emitter
• Java client generator – The official TypeSpec Java emitter
• Python client generator – The official TypeSpec Python emitter
• TS client generator – The official TypeSpec TS emitter

Contributing

We welcome contributions from the community! If you have a resource you think should be added, please:

1. Fork this repository.
2. Add your resource to the relevant section.
3. Submit a pull request.

Please make sure your resource is relevant and helpful for others learning or using TypeSpec.