Skip to content

Installation

For the usual visual workflow, open BLine Web and install BLine-Lib in the robot project. The editor and robot library are separate: editing a path does not require robot code, and code-generated paths do not require the editor.

1. Open BLine Web

Browser

Open bline-web.pages.dev in a desktop-class browser. No installation is required.

The browser editor stores projects in browser-local persistent storage. Use Project → Import / Export → Export Autos Folder… to produce robot-ready files and Export Project Archive… for a portable editor backup.

Do not rely on browser storage as your only copy

Browser data belongs to that browser profile and site origin. Export the project into version control regularly.

Desktop

The desktop build can edit an FRC repository or autos folder directly. Current desktop builds are prereleases:

Download Windows x64

Download Linux x64

Use GitHub Releases if a channel link is unavailable. BLine Web currently warns that mobile support is limited; use a laptop or desktop for path authoring.

When the desktop app asks for a folder, choose either:

  • the robot repository root, if it contains src/main/deploy; or
  • src/main/deploy/autos directly.

The app resolves a selected robot repository to src/main/deploy/autos and creates missing config.json, paths/, and editor metadata as needed.

2. Install BLine-Lib

The current robot-library release is v0.9.1 for WPILib 2026 and Java 17.

Vendor JSON

  1. Open the FRC robot project in WPILib VS Code.
  2. Open the Command Palette with Ctrl+Shift+P or Cmd+Shift+P.
  3. Run WPILib: Manage Vendor Libraries.
  4. Choose Install new libraries (online).
  5. Paste:
https://bline-metrics.edan-liahovetsky.workers.dev/vendor/BLine-Lib.json

If that endpoint is unavailable, use the direct source file:

https://raw.githubusercontent.com/edanliahovetsky/BLine-Lib/main/BLine-Lib.json

Both URLs describe the same current release. Reinstall from the same URL when upgrading the pinned vendor dependency.

Gradle alternative

Add JitPack and pin the release tag:

repositories {
    maven { url 'https://jitpack.io' }
}

dependencies {
    implementation 'com.github.edanliahovetsky:BLine-Lib:v0.9.1'
}

Use an exact tag in a competition project. A snapshot of main can change without warning.

3. Verify the library

This import should resolve after Gradle refreshes:

import frc.robot.lib.BLine.*;

Build the robot project before proceeding. If the dependency does not resolve, see Common Issues.

Legacy BLine-GUI

Maintaining an older PySide project

BLine-GUI is the legacy editor. Current BLine Web can import and migrate legacy path/autos data; re-export and verify the result before deploying it. New tutorials and visuals document BLine Web. See the legacy repository only when maintaining that older workflow.

Next

Continue with First Path Tutorial to configure the editor, export a path, wire the drivetrain, and run it safely.