launchrail

Launchrail

Launchrail is an open-source 6DOF High-Powered Rocket Simulator. It leverages OpenRocket design files for configuration and ThrustCurve API for motor curves. The project also explores using financial algorithms to model atmospheric turbulence.

🚀 Getting Started

git clone https://github.com/bxrne/launchrail.git
cd launchrail

go run ./cmd/launchrail
# For hot reload (development)
air

🐳 Docker Usage

You can run Launchrail as a Docker container, either by building locally or pulling from GHCR.

Build and Run Locally

DOCKER_BUILDKIT=1 docker build -t launchrail:latest .
docker run --rm -it -p 8080:8080 launchrail:latest

Pull and Run from GHCR

docker pull ghcr.io/bxrne/launchrail:latest
# Or pull a specific version
docker pull ghcr.io/bxrne/launchrail:<tag>
docker run --rm -it -p 8080:8080 ghcr.io/bxrne/launchrail:latest

🧑‍💻 Contributing & Git Workflow

We welcome contributions! See CONTRIBUTING.md for full guidelines.

• Clone and branch:

  git clone https://github.com/bxrne/launchrail.git
  git checkout -b my-feature-branch
  

• Run tests:

  go test ./... -v
  

• Lint:

  golangci-lint run ./...
  

• Commit using Commitizen:

  cz commit
  

  This project uses Commitizen and Conventional Commits for semantic versioning (see .cz.toml). Semantic versioning is enforced for all releases and PRs. Please use cz commit to ensure proper versioning and changelogs.

🧪 Testing

Run all tests:

go test ./... -v

🛠️ Built With

• Go — The Go Programming Language
• OpenRocket — Model rocket design and simulation
• ThrustCurve — Model rocket motor database

📦 License

This project is licensed under the GNU General Public License v3.0 — see the LICENSE file for details.