Skip to content

CONTRIBUTING.md

Latest commit

 

History

History
100 lines (71 loc) · 2.57 KB

CONTRIBUTING.md

File metadata and controls

100 lines (71 loc) · 2.57 KB

Contributing to Sequin

Thank you for your interest in contributing to Sequin! This document provides guidelines for contributing to the project.

Development setup

Prerequisites

  • Elixir 1.18+
  • PostgreSQL 14+
  • GitHub CLI (gh)
  • Node.js (for frontend assets)
  • Go (only necessary for CLI development)

Getting started

  1. Fork and clone the repository

  2. Start PostgreSQL and Redis with docker compose

    docker compose up -d

    If you encounter an error about the default PostgreSQL user "postgres" not existing, you can create the user with:

    createuser -s postgres

  3. Run the setup script

    mix setup

  4. Start the development server:

    make dev

The app will be available at http://localhost:4000.

Sequin uses LiveView + LiveSvelte for its frontend. As a monolith, the entire app is available at http://localhost:4000.

Development workflow

  1. Create a new branch for your changes
  2. Make your changes
  3. Run tests: 
    # Run Elixir tests
mix test
  4. Push your changes and open a pull request
  5. Run make signoff to verify your changes pass all checks

Signoff process

For external contributors

When you submit a pull request, GitHub Actions will automatically run a series of checks.

After your PR passes, we will review your changes and hopefully merge!

If you need to reach us sooner, the fastest way is through our Discord server.

For core contributors

Core contributors with repository access should run the signoff script before merging:

# From the project root
./scripts/signoff.sh

This script:

  1. Checks code formatting
  2. Performs compilation with warnings as errors
  3. Runs all tests
  4. Performs linting and other checks
  5. Updates the GitHub commit status with a signoff

Code style

  • Elixir: Follow the standard Elixir formatting (enforced by mix format)
  • TypeScript/JavaScript: Use Prettier (enforced by the signoff process)
  • Go: Use standard Go formatting (enforced by go fmt)
  • SQL: Use lowercase for keywords

Documentation

  • Update relevant documentation in the docs/ directory
  • Follow the style guide for documentation
  • Run the docs locally using make docs

Getting help

  • Join our Discord server for questions and discussions
  • Open an issue for bugs or feature requests
  • Tag maintainers in your PR if you need help

License

By contributing to Sequin, you agree that your contributions will be licensed under the MIT License.