BCForge – Business Central Governance

Enforce AL coding standards, manage BC object ID ranges, and stay in sync with your team's governance rules — all without leaving VS Code.

Features

⚡ Rule Sync

Pull the active rules from your BCForge workspace directly into VS Code. Violations are shown as diagnostics in the Problems panel with severity levels (error, warning, info) and rule categories (naming, structure, performance, security, documentation).

Use BCForge: Sync Rules from the Command Palette to refresh at any time, or configure a .bcforge.json file in your project root to sync automatically on activation.

📐 ID Range Manager

A dedicated BCForge panel in the Activity Bar shows all BC object ID ranges registered for your workspace. See at a glance which ranges are allocated, to which app, and what IDs are still available in your organisation's pool.

Use BCForge: Suggest ID Range to ask BCForge to find the next available non-overlapping range of any size you specify — drawn from your organisation's configured pool.

🔑 API Key Authentication

Sign in with a BCForge API key (generated in your workspace settings). Your key is stored securely in VS Code's secret storage — never in plaintext settings.

Getting Started

1. Create a `.bcforge.json` file in your project root

{
  "org": "your-org-slug",
  "workspace": "your-workspace-slug"
}

Both slugs are visible in the URL when you open a workspace in the BCForge web app: https://bcforge.app/org/your-org-slug/workspace/your-workspace-slug

Open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and run:

BCForge: Sign In with API Key

Generate an API key in BCForge → Workspace Settings → API Keys.

3. Sync rules

BCForge: Sync Rules

Violations will appear in the Problems panel (Cmd+Shift+M).

Extension Settings

Setting	Default	Description
`bcforge.serverUrl`	`https://bcforge.app`	Base URL of the BCForge platform (change only for self-hosted deployments)
`bcforge.orgSlug`	empty	Your organisation slug. Overrides `.bcforge.json` if set.
`bcforge.workspaceSlug`	empty	Your workspace slug. Overrides `.bcforge.json` if set.

Settings in .bcforge.json take precedence for per-project configuration. VS Code settings are used as a fallback.

Commands

Command	Description
`BCForge: Sign In with API Key`	Authenticate with a BCForge API key
`BCForge: Sign Out`	Remove stored credentials
`BCForge: Sync Rules`	Pull latest rules from your BCForge workspace
`BCForge: Show Status`	Show current connection and sync status
`BCForge: Suggest ID Range`	Request a free, non-overlapping ID range suggestion
`BCForge: Refresh ID Ranges`	Refresh the ID Ranges panel

Requirements

VS Code 1.90 or later
A BCForge account with at least one workspace
A BC/AL project (extension activates on .al files)

BCForge – Business Central Governance

BCForge

BCForge – Business Central Governance

Features

⚡ Rule Sync

📐 ID Range Manager

🔑 API Key Authentication

Getting Started

1. Create a .bcforge.json file in your project root

2. Sign in

3. Sync rules

Extension Settings

Commands

Requirements

More Information

1. Create a `.bcforge.json` file in your project root