Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
This article provides the best learning resources for developers who are getting started building TypeSpec apps. These resources help you understand the fundamentals of TypeSpec, explore advanced features, and integrate TypeSpec into your development workflow.
TypeSpec reached 1.0 general availability, marking its maturity as a production-ready API-first development platform with stable core components and enhanced code generation capabilities.
Official documentation
The TypeSpec Documentation is the primary resource for learning about TypeSpec. It includes comprehensive guides, API references, and tutorials to help you get started using TypeSpec.
TypeSpec blog
The TypeSpec Blog provides announcements, feature updates, and insights into TypeSpec development. Check the blog regularly to stay informed about new releases, best practices, and community highlights.
Getting started guides
TypeSpec offers comprehensive getting started guides for different development scenarios:
- Getting Started with TypeSpec for REST APIs - A step-by-step tutorial covering setup, basic syntax, models, operations, and best practices.
- Getting Started Guide for OpenAPI - An introduction to TypeSpec using concepts familiar to developers that build or use API definitions in OpenAPI v2 or v3.
TypeSpec playground
The TypeSpec Playground is an interactive web-based tool where you can experiment with TypeSpec syntax and features in real-time. It provides immediate feedback and validation, making it easier to learn and adopt TypeSpec.
Language reference
The Language Reference provides detailed information about TypeSpec's core concepts, functions, and modules. It's an essential resource for understanding the full capabilities of TypeSpec and how to use them effectively.
TypeSpec for Microsoft 365 Copilot
TypeSpec for Microsoft 365 Copilot is a domain-specific language for building declarative agents and API plugins for Microsoft 365 Copilot. It provides type-safe development with automatic manifest generation, making it easier to create custom Copilot extensions.
Community and support
Join the TypeSpec Community to connect with other developers, ask questions, and share your experiences. The community provides multiple channels for engagement:
- Discord - Real-time discussions and direct engagement with the TypeSpec community.
- GitHub Discussions - Post questions, share ideas, report bugs, and showcase projects in organized categories including Q&A, Language Suggestions, and Show-and-Tell.
Videos
Watch videos to see TypeSpec in action. These recordings cover various topics, including API design best practices, TypeSpec features, and real-world use cases:
- APIs at scale with TypeSpec - Overview of TypeSpec's capabilities presented at the 2024 Austin API Summit by Microsoft, demonstrating how Microsoft uses TypeSpec at scale.
- TypeSpec 101 - Comprehensive tutorial series covering setup, modeling, operations, responses, authentication, versioning, and best practices.
- Schema-first API design using TypeSpec - Introduction to schema-first API design principles with TypeSpec.