VS Code / Cursor extension: mute presentation for .feature files —
- Format Document — indent + align tables
- Syntax highlighting — keywords, steps, comments, tags, tables, strings (theme scopes)
No binding index. No LSP. No step matching. Companion to BDD Guardian.
|
|
| Marketplace |
anghelll.bdd-gherkin-format |
| Version |
0.3.0 |
| Publisher |
anghelll |
Why a separate extension?
ForgeOne splits concerns on purpose:
| Extension |
Role |
| BDD Gherkin Format (this) |
How .feature looks — layout + syntax colors |
| BDD Guardian |
What steps mean — step ↔ binding map |
| BDD Pilot |
Run tests / TRX |
| BDD Jarvis |
Workspace insights / context packs |
Incumbents (Cucumber Official, Full Support) bundle format + highlighting with a second resolver. This extension stays mute on the map: presentation only, so you can drop those bundles without fighting Guardian.
Install
- Marketplace: BDD Gherkin Format, or Install from VSIX →
bdd-gherkin-format.vsix
- Recommended: BDD Guardian for bindings
- Open a
.feature → syntax colors apply; Format Document / format-on-save (defaults for [gherkin])
If another formatter is installed (e.g. Cucumber Official), pick this one:
"[gherkin]": {
"editor.defaultFormatter": "anghelll.bdd-gherkin-format",
"editor.formatOnSave": true
}
Disable formatting with bddGherkinFormat.enabled: false (highlighting stays).
What it does
- Indent Feature / Rule / Scenario / steps / Examples / tables (2-space default;
indentSize or editor tab size)
- Official EN synonyms:
Example, Scenario Template, Scenarios, Business Need, Ability, *
- Align consecutive
|…| table columns (padding only; numeric cells right-aligned; \| stays in-cell)
- Format Selection
- Editor language config: fold by indent, Enter after keywords,
# comments, @tag / <placeholder> word pattern
- TextMate highlighting: structural keywords, step keywords,
# comments, @tags, tables, quotes, DocString fences
- Language id
gherkin for .feature (works even without Guardian)
What it does not do
- Index or validate step bindings (no bound/unbound colors — that is Guardian)
- Autocomplete, diagnostics, generate binding, run tests
- LSP / undefined-step / glue globs
- Custom color palette (uses your VS Code theme scopes)
- Full i18n Gherkin keyword sets (English dialect + synonyms in v0.3)
Settings
| Setting |
Default |
Description |
bddGherkinFormat.enabled |
true |
Enable Format Document / Selection |
bddGherkinFormat.indentSize |
null |
Spaces per indent unit. null uses the editor tab size (Gherkin defaults to 2) |
bddGherkinFormat.alignNumbers |
true |
Right-align numeric table cells (integers and decimals) |
Develop
npm install
npm run verify:local # lint + tests + VSIX (Capa A)
See CONTRIBUTING.md · ROADMAP.md · docs/IDEATION.md · docs/EXTENSION_PACK.md
License
MIT
