Udara Whitelabel for VS Code

Browse the whitelabel clients of a Flutter project, inspect their env files, and run or build any client without leaving the editor. The extension is a thin UI over udara_cli; every action runs the CLI so results match what you get in a terminal.

Install

From the Marketplace: https://marketplace.visualstudio.com/items?itemName=deecency.udara-whitelabel (or search "Udara Whitelabel" in the Extensions view).

Requirements

• udara_cli on your PATH (dart pub global activate udara_cli), or set udara.cliPath.
• A Flutter project with a clients/ folder (run udara_cli setup --clients … or use Udara: Set Up Clients… from the view).

Features

Clients view (activity bar → Udara)

• One node per client showing its app name and bundle id.
• Expand a client to see .env / .env_test; expand a file to see every key. Secret-looking values (TOKEN, SECRET, PASSWORD, KEY) are masked; use Copy Value to grab them. Click a key to jump to its line.
• Inline actions on a client: Run and Build. Right-click for Run with Test Env, Whitelabel, and Doctor.

Run Client runs udara_cli whitelabel --client <name> --keep as a task, then starts a normal Flutter debug session through the Flutter extension (Dart-Code). Projects that use udara_cli's generated app config (1.3.1+) have the client's values compiled in; projects that still bundle .env also get --dart-define=CLIENT_ENV=.env. You get the usual debug toolbar, hot reload on save, breakpoints and DevTools, on the device chosen in the Flutter device selector. Without the Flutter extension, or with udara.launchMode set to terminal, it runs flutter run in a terminal instead. The status bar shows which client the project is currently branded as.

Build Client… asks for platform, Android build type, environment and an optional app version, runs udara_cli build, and offers to reveal the artifact when it finishes. The version (e.g. 1.4.0+12) is passed to the CLI; pubspec.yaml is not edited. 1.4.0 without a build number keeps the current one.

Build Multiple Clients… picks several clients, Android and/or iOS, AAB and/or APK, the version (keep pubspec, one for all, or one per client), how many to build in parallel (Auto or 1-4), test env and fail-fast, then runs them as one udara_cli build batch. It reports how many builds succeeded and opens build/udara/ or the per-job logs.

Progress: every build shows a notification and a status bar item with percent, ETA and what each running job is doing. Cancel it from the notification to stop the build and every process it started.

Requires udara_cli 1.3.1 or newer; the extension tells you if yours is older.

Build History view lists every recorded build from .udara_build_history.json with pass/fail icons, duration, and a tooltip with the error message. Reveal the artifact or copy the error inline.

Other commands: Doctor, Clean, Diff Two Clients…, Set Up Clients…, Clear Build History, Install udara_cli. Set Up Clients… can start the new clients' .env files from an existing client (udara_cli 1.3.2+).

Settings

Development

cd extensions/vscode
npm install
npm run compile      # or: npm run watch
npm test             # unit tests for the pubspec version helper
npm run package      # produces udara-whitelabel-<version>.vsix

Press F5 in VS Code with this folder open to launch an Extension Development Host, then open a Flutter project that has a clients/ folder. Install a packaged build with code --install-extension udara-whitelabel-*.vsix.