# Dovetail

> A language for business logic, compiling to WebAssembly with typed errors and structured concurrency.

Read only the relevant Markdown chapters below. This site follows the latest published release; use the
book at your compiler/library revision when behavior differs. Chapters marked as
design outlines do not imply implemented runtime features.

The [complete book](https://dovetaillang.org/llms-full.txt) is available when the whole reference is needed.

## Book and guides

- [Part 1: Getting Started](https://dovetaillang.org/book/getting-started.md): Install Dovetail, set up your editor, and run your first program.
- [Part 2: Dovetail Tool Commands](https://dovetaillang.org/book/tool-commands.md): Compiler commands, workspace manifests, dependencies, and runtime permissions.
- [Part 3: Language Basics](https://dovetaillang.org/book/language-basics.md): Layout, bindings, primitive types, operators, and string interpolation.
- [Part 4: Control Flow](https://dovetaillang.org/book/control-flow.md): Conditional expressions, exhaustive pattern matching, and loops.
- [Part 5: Functions](https://dovetaillang.org/book/functions.md): Functions, named arguments, closures, and function references.
- [Part 6: Type System](https://dovetaillang.org/book/type-system.md): Records, enums, newtypes, collections, modules, extensions, and interfaces.
- [Part 7: Generics](https://dovetaillang.org/book/generics.md): Generic functions and types with explicit constraints.
- [Part 8: Traits and Implementations](https://dovetaillang.org/book/traits.md): Traits, implementations, inheritance, defaults, and method resolution.
- [Part 9: Classes and Object-Oriented Programming](https://dovetaillang.org/book/classes.md): Classes, encapsulation, inheritance, mutable state, and identity.
- [Part 10: Error Handling](https://dovetaillang.org/book/error-handling.md): Option, Result, early returns, and the boundary between failures and defects.
- [Part 11: Packages and Modules](https://dovetaillang.org/book/packages.md): Packages, imports, visibility, and Git dependencies.
- [Part 12: Async Programming](https://dovetaillang.org/book/async.md): Deferred async work, execution, structured concurrency, and cancellation.
- [Part 13: Resource Management](https://dovetaillang.org/book/resources.md): Resource acquisition, ownership scopes, composition, and reliable cleanup.
- [Part 14: Streams](https://dovetaillang.org/book/streams.md): Stream sources, transformations, concurrent merging, and byte transports.
- [Part 15: Testing](https://dovetaillang.org/book/testing.md): Test declarations, organization, attributes, filtering, and execution.
- [Part 16: Macros](https://dovetaillang.org/book/macros.md): Built-in derives and custom derive macros written in Rhai.
- [Part 17: Components](https://dovetaillang.org/book/components.md): WebAssembly component dependencies, generated bindings, and SQLite.
- [Part 18: Project Structure and Onion Architecture](https://dovetaillang.org/book/project-structure.md): Project boundaries, dependency direction, ports, adapters, and composition.
- [Part 19: The Domain Layer](https://dovetaillang.org/book/ddd.md): Model business rules with value objects, entities, aggregates, and transitions.
- [Part 20: The Application Layer](https://dovetaillang.org/book/application-layer.md): Use cases, repositories, transactions, and obligations; includes design outlines.
- [Part 21: Strategic Design and Context Mapping](https://dovetaillang.org/book/context-mapping.md): Bounded contexts, public contracts, and integration events; includes design outlines.
- [Part 22: Standard Library Overview](https://dovetaillang.org/book/stdlib.md): Available standard-library projects, API areas, and current limitations.
- [Part 23: Best Practices](https://dovetaillang.org/book/best-practices.md): Naming, functional patterns, error handling, and project organization.
- [Part 24: Prefixed String Literals](https://dovetaillang.org/book/prefixed-literals.md): Typed string builders, interpolation, parameterized SQL, and custom prefixes.
- [Part 25: Tuple Extension (Advanced)](https://dovetaillang.org/book/tuple-extension.md): Tuple extension, recursive implementations, and parser composition.
- [Part 26: Advanced Generics](https://dovetaillang.org/book/advanced-generics.md): Advanced bounds, variance, associated types, and generic associated types.
- [Part 27: Production Deployment and CI](https://dovetaillang.org/book/production-deployment.md): Reproducible images, CI, runtime grants, deployment, and rollback.
- [The Dovetail Programming Language](https://dovetaillang.org/book.md): The complete Dovetail language book, organized by chapter.
- [Book validation](https://dovetaillang.org/guides/book-validation.md): How the book’s links and complete examples are validated.
- [Dovetail Language Grammar](https://dovetaillang.org/reference/grammar.md): The lexical and syntactic grammar of Dovetail.
- [Formatting Dovetail](https://dovetaillang.org/guides/formatting.md): Canonical formatting and editor integration.
- [Container images](https://dovetaillang.org/guides/container-images.md): OCI image configuration, runtime matching, and reproducible builds.