Freerouting is an advanced autorouter for all PCB programs that support the standard Specctra or Electra DSN interface.
- Java >= 25 (Adoptium Temurin 25 JRE)
- Gradle 9.x
- Internet connection (dependencies are downloaded automatically)
- For IDE integration: Gradle extension (not necessary for command line usage)
Open the freerouting Gradle project in your favourite IDE (NB, IntelliJ, Eclipse etc. with Gradle Plugin) and build it by calling the assemble task.
Navigate to the Gradle project (e.g., path/to/freerouting) and enter the following command
./gradlew assemblegradlew executableJarAll four .jar files will be generated in the build\libs subfolder. You would typically run the freerouting-current-executable.jar file.
Creating a release takes about half an hour if everything goes according to the plan. Usually it doesn't, so free up ~3 hours for this.
Let's suppose that the new version is 2.3.4. You need to complete these steps:
-
Run the
gradlew wrapper --gradle-version latestcommand to update the Gradle wrapper to the latest version. -
Run the
./gradlew dependencyUpdates useLatestVersions --no-configuration-cache --no-parallelcommand to check if there are any dependencies that need to be updated. Update them manually if necessary and commit the changes. -
Check if there are any outstanding pull requests and merge them as well
-
Change
ext.publishing.versionIdin\gradle\project-info.gradleto2.3.4 -
Push it to GitHub
-
Check if it was built successfully on GitHub Actions
-
Create a new draft release
-
Run
gradlew.bat executableJar-> this will generate the files in\build\libs\freerouting*.jar -
Rename to
freerouting-current-executable.jartofreerouting-2.3.4.jar -
Update the
integrations\KiCad- Copy
freerouting-2.3.4.jarinto\integrations\KiCad\kicad-freerouting\plugins\jar\ - Update
\integrations\KiCad\kicad-freerouting\plugins\plugin.iniwith the new filename - Update
\integrations\KiCad\kicad-freerouting\metadata.json - Create a ZIP file from the
kicad-freeroutingfolder - Copy this
kicad-freerouting.zipfile tokicad-freerouting-2.3.4.zip - Use KiCad Packager from https://gitlab.com/kicad/addons/metadata/tools to get hash and file sizes
- Update
\integrations\KiCad\metadata.jsonwith these values - Push these changes to GitHub
- Run the "Run KiCad repository validation" command in KiCad Packager
- Delete previous fork at https://gitlab.com/freeroutingapp/metadata (Settings / General / Delete this project)
- Fork https://gitlab.com/kicad/addons/metadata again
- Create a new branch, named
freerouting-2.3.4 - Replace https://gitlab.com/freeroutingapp/metadata/-/blob/main/packages/app.freerouting.kicad-plugin/metadata.json with the new one
- Create a merge request at https://gitlab.com/kicad/addons/metadata / Merge request / ...
- Copy
-
Update README.md, integrations.md, self-hosting.md and settings.md
-
Publish the release
-
Check if Windows, Linux and macOS installers were added to the release in GitHub Actions and if the Docker image was updated on GHCR.io
-
Publish the library to Maven Central
- Use the Gradle Maven plugin and set the properties in
/.gradle/gradle.properties
- Run the
./gradlew publishToMavenCentral --no-configuration-cachecommand in the root folder to publish it to Maven Central - Publish the deployment on Maven Central Repository
- Use the Gradle Maven plugin and set the properties in
-
Update the Docker image on Azure
- build docker image locally for Linux x64 (~2 mins)
docker build -t freerouting:latest . - tag the docker image
docker tag freerouting:latest freerouting.azurecr.io/freerouting/api:latest - push image to Azure as freerouting.azurecr.io/freerouting/api:latest
az login az acr login --name freerouting docker push freerouting.azurecr.io/freerouting/api:latest
- build docker image locally for Linux x64 (~2 mins)
-
Change
ext.publishing.versionIdin\gradle\project-info.gradleagain to2.3.5-SNAPSHOT -
Test and publish a new version of the Python Freerouting Client on PyPi.org (in the separate
freerouting-python-clientrepository) -
Optionally regenerate non-official SDK scaffolds from this repository before preparing SDK PRs:
./scripts/sdk/regenerate-all.ps1 -SharedVersion 2.3.4./scripts/sdk/generate-javascript-client.ps1./scripts/sdk/generate-csharp-client.ps1./scripts/sdk/generate-cpp-client.ps1
Freerouting keeps its official API clients in separate repositories from the core Java codebase.
- Current official support: Python only (repository:
freerouting-python-client). - We also see active demand for additional SDKs, especially JavaScript and C++.
- SDKs and the Freerouting server have different release cadences and dependency ecosystems.
- Language-specific CI/CD and package publishing (PyPI, npm, etc.) stay isolated and easier to maintain.
- Users get cleaner issue tracking and documentation per language.
- The OpenAPI definition from this repository is the canonical API contract.
- SDK repositories should generate client code from that OpenAPI contract, then keep a small handwritten layer for ergonomics.
- Keep generated code reproducible by committing generation config and templates into each SDK repository.
- Start with JavaScript first (higher ecosystem demand and lower maintenance cost than C++ bindings).
- Add C++ only with clear ownership and a maintained packaging/distribution plan.
- Keep one repository per SDK (
freerouting-js-client,freerouting-cpp-client) instead of mixing multiple language toolchains into this repository.
It is both possible and recommended to add templates/scripts that regenerate the JavaScript client at each Freerouting release.
This repository includes starter generator scripts in scripts/sdk/ for Python, JavaScript, C#, and C++.
Officially supported client publishing remains Python-only for now.
Use scripts/sdk/regenerate-all.ps1 when you want one command that keeps all generated SDK scaffolds aligned to the same API and version.
Recommended guardrails:
- Trigger generation from release tag events (or manually for pre-releases).
- Open an automated PR in the JavaScript SDK repository with the regenerated client and changelog.
- Run SDK tests in CI before merge; publish to npm only after PR approval.
- Avoid direct auto-publish on generation alone to reduce risk from contract-breaking changes.
- Apply the same PR-first approach for C# and C++ scaffolds (generate, test in SDK repo, review, then publish).
- Freerouting follows Google coding conventions from Google Java Style, and the configured OpenRewrite recipe
org.openrewrite.staticanalysis.CodeCleanupapplies those rules automatically to the codebase. - Run the cleanup recipe locally with the Rewrite task:
./gradlew rewriteRun
- Run the same command before committing so formatting stays consistent with the automated checks.

