fastbuild-bff-mode

Emacs major mode for FASTBuild BFF (Build Configuration) files with syntax highlighting and context-aware completion.

Features

• Syntax highlighting for:

  • Functions (Library, Executable, ObjectList, Compiler, etc.)
  • Preprocessor directives (#include, #if, #define, etc.)
  • Properties (.Compiler, .CompilerOptions, etc.)
  • Variable references ($VarName$)
  • Built-in variables (_CURRENT_BFF_DIR_, _WORKING_DIR_, etc.)
  • Keywords (true, false, function, in)
  • Platform symbols (__WINDOWS__, __LINUX__, __OSX__)

• Smart indentation based on bracket nesting

• Context-aware completion - when inside a function body, only relevant properties are suggested:

  • Inside Library() { } → .Compiler, .LibrarianOptions, .PCHInputFile, etc.
  • Inside Executable() { } → .Linker, .LinkerOutput, .Libraries, etc.
  • Inside Unity() { } → .UnityInputPath, .UnityOutputPattern, etc.

• Electric pairs for automatic bracket/quote closing

Installation

(use-package fastbuild-bff-mode)

Usage

The mode activates automatically for .bff files.

Trigger completion with your preferred completion frontend:

• Built-in: M-x completion-at-point or C-M-i
• company-mode: completion popup appears automatically
• corfu: completion popup appears automatically

Customization

;; Change indentation offset (default: 4)
(setq fastbuild-bff-indent-offset 2)

License

GPL-3.0-or-later