# Contributing to Bolt Thank you for your interest in contributing to Bolt! This document provides guidelines and instructions for contributing to the project. ## Getting Started Bolt is hosted on [SourceHut](https://sr.ht/~eugenetriguba/Bolt/). If you're new to SourceHut, see the [git.sr.ht quickstart](https://man.sr.ht/git.sr.ht/). You do not need an account on SourceHut to contribute. ## How to Contribute Bolt uses an [email-based workflow](https://git-send-email.io/) for accepting contributions. - Patches should be submitted via email to my [public-inbox mailing list](https://lists.sr.ht/~eugenetriguba/public-inbox) with the subject prefix `[PATCH bolt]`. - General questions and discussions about the bolt project can be sent to my [public-inbox mailing list](https://lists.sr.ht/~eugenetriguba/public-inbox). - Bug reports can be submitted to my [public-inbox mailing list](https://lists.sr.ht/~eugenetriguba/public-inbox). For general questions, discussions, or bug reports, please make it obvious in the subject line it is for the bolt project. ## Development Setup ### Prerequisites - Go 1.23.0 or later - Docker (for running database integration tests) - git ### Initial Setup 1. Clone the repository: ```bash git clone https://git.sr.ht/~eugenetriguba/bolt cd bolt ``` 2. Install dependencies: ```bash go mod download ``` 3. Build the project: ```bash go build -o bolt ./cmd/bolt ``` ### Running Tests Bolt has integration tests for all supported databases. The test suite uses docker containers to run database instances. Run all tests: ```bash ./scripts/test.sh ``` Run all tests and leave database containers running: ``` ./scripts/test.sh --keepdb ``` Run tests for a specific database: ```bash ./scripts/test.sh postgres ./scripts/test.sh mysql ./scripts/test.sh mssql ./scripts/test.sh sqlite3 ```