Skip to content

doc: B8 — Build profiles page #756

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
NikolaRHristov merged 1 commit into from
May 4, 2026
Merged

doc: B8 — Build profiles page #756

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
42 changes: 42 additions & 0 deletions Source/Content/doc/profiles.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,42 @@
---
title: Build profiles
description: Land ships three Sky workbench bundles under three profile names. They differ in which workbench bundle the webview loads, whether SkyBridge runs, and whether Output transforms are applied — but all three spawn Cocoon as the extension host.
---

Land ships three Sky workbench bundles under three profile names.
They differ in which workbench bundle the webview loads, whether
SkyBridge runs, and whether Output transforms are applied — but all
three spawn Cocoon as the extension host.

Three Sky workbench bundles ship under three profile names: `debug`
loads the stock VS Code browser workbench raw (no SkyBridge),
`debug-mountain` loads the same bundle plus SkyBridge runtime
registrations, `debug-electron` loads the electron-bundled stock
workbench plus SkyBridge plus the full Output transform pipeline.
Cocoon spawns in all three — the debug-mountain name doesn't mean
Cocoon is gone, only that the Output transform pipeline is. Pick
`debug-electron` for full extension UX, `debug-mountain` for fewer
wire-shape bugs to chase, `debug` for stock-VS-Code-only sanity
testing.

## Profile matrix

| Profile | Workbench bundle | SkyBridge installed? | Wind bootstrap? | Output transforms run? |
|---|---|---|---|---|
| `debug` (`Browser=true`) | Stock browser workbench | No | No | No |
| `debug-mountain` (`Mountain=true`) | Stock browser workbench | Yes | Yes | No (gated on `Electron=true`) |
| `debug-electron` (`Electron=true`) | Stock electron workbench | Yes | Yes | Yes |

## Where this lives

| Concern | File |
|---|---|
| Profile sentinel + LAND_PROFILE env baking | `Element/Mountain/build.rs` |
| Three Sky bundle entry points | `Element/Sky/Source/Workbench/{Browser,Mountain,Electron}.astro` |
| Output transform gating | `Element/Output/Source/Plugin/Index.ts` (`Enabled: () => process.env["Electron"] === "true"`) |
| Cocoon spawn (unconditional) | `Element/Mountain/Source/Binary/Main/AppLifecycle.rs:431` |

## What's next

- [Architecture: processes & peers](/Doc/architecture-processes) — what each process does
- [Build pipeline](/Doc/build-pipeline) — how each profile's bundle is produced
Loading