Developers#

Welcome to the SQLSpec developer documentation! SQLSpec is a type-safe SQL query mapper and connectivity layer designed for high performance with minimal abstraction. Whether you are building new database adapters, enhancing the query builder, fixing a bug, or improving documentation, this section provides the essential resources to get started.

Contribution Guide

Environment setup with uv, development workflow, coding standards (PEP 604, typing, docstrings), and repository quality gates.

Contribution Guide
Creating Adapters

Architecture guide for authoring new synchronous and asynchronous database adapters, driver base classes, statement configs, and feature flags.

Creating Adapters
Releases & Versioning

Release lifecycle, Semantic Versioning standards, pre-release cadences, LTS deprecation policies, and the automated CI publishing pipeline.

SQLSpec Releases
Changelog

Comprehensive version-by-version change log covering features, bug fixes, breaking changes, and migration notes across all releases.

Changelog