> For the complete documentation index, see [llms.txt](https://docs.flxbl.io/flxbl/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flxbl.io/flxbl/codev/development/workspace-explorer-web.md).

# Workspace Explorer (Web)

The web app's Workspace Explorer browses your **repository** — no local workspace involved. Pick a branch, explore what the project contains, see what the next build would package, read code analysis findings, and generate **AI insight reports** for a package or a whole domain. Editing source, retrieving from orgs, and creating domains happen in the [desktop workspace](/flxbl/codev/development/development.md); the one change you make from here is a project owner editing a diff package's build **baseline** (see [Package baselines](#package-baselines)).

The page has two explorers, switched at the top of the tree, and a set of tabs on the right that follow what you select.

## Component Explorer

The **Component Explorer** shows the branch's source as a tree — package, metadata category, type, component — with the same filters as the rest of the page (domain, package, type, modified). Selecting a component opens it read-only in the **Code** tab.

<figure><img src="/files/ak4BqR8pURZHVmcKrP2f" alt="The web Workspace Explorer&#x27;s Component Explorer with a field selected and the Analysis tab listing code analysis findings with severity, rule, and file path"><figcaption><p>Component Explorer — a component selected, with the Analysis tab listing code analysis findings for the branch.</p></figcaption></figure>

The **Analysis** tab lists the branch's code analysis findings — rule, severity, message, and file — with the totals summarised at the top. Analysis is collected automatically for the branch (and refreshed daily), so the findings are ready when you open the tab; see [Change Analysis](/flxbl/codev/inspect/change-analysis.md) for the analyzer itself.

## Build preview

The Component Explorer can scope the tree to **what the next build would package**, instead of every file in the repository. codev computes this preview in the background when you open a branch — it runs the build without producing artifacts and records the files each package would include, which appear a minute or two after the tree loads.

<figure><img src="/files/0rSAJ45PPEJGcJCCbyuB" alt="The Component Explorer tree in Build payload view, with package rows showing an in-build file count and a base commit chip, and a build payload tag in the count bar"><figcaption><p>Build payload view — the tree scoped to what the next build packages, with per-package counts and the baseline each package is measured from.</p></figcaption></figure>

A toggle in the tree toolbar switches between **Build payload view** and **All files view**; build payload view is on by default. It is an overlay, not a filter — a package the preview could not resolve keeps its full contents rather than disappearing. Each package row shows how many files it contributes and, for a diff package, the [baseline](#package-baselines) commit it is measured from. **Refresh Tree** recomputes the preview; the count bar flags when a package could not be resolved, or when the branch has moved past the commit the preview was computed for.

## Module Explorer

The **Module Explorer** shows the same repository as domains and packages: each domain with its pool and packages, plus an **Unassigned Packages** group. Selecting a domain or a package drives the tabs on the right — **Insight**, **Versions** (packages only, the same list as [Packages → Versions](/flxbl/codev/development/packages.md#versions)), and **Configuration**, which shows the domain's release configuration or the package's project entry — and, for a package, its build **baseline** (see [Package baselines](#package-baselines)).

<figure><img src="/files/NTYrYxblfYWXkq04UKcT" alt="The Module Explorer with the frameworks domain selected and its AI insight report open, showing the report header with commit, age, duration, and model, and the report&#x27;s table of contents"><figcaption><p>Module Explorer — a domain selected, with its AI insight report in the Insight tab.</p></figcaption></figure>

## Package baselines

Selecting a package and opening the **Configuration** tab shows its **Package Baseline** — the commit the package is measured from on the current branch.

<figure><img src="/files/9eqa8fmetwDWBDIMJG38" alt="The Configuration tab for a diff package, showing the Package Baseline card with the fallback baseline, latest published version, per-environment baselines, and an Edit Baselines button"><figcaption><p>The Package Baseline card in the Configuration tab — the fallback baseline, the environment baselines, and the commit the next build will use.</p></figcaption></figure>

For a **diff package** the baseline is the packaging boundary: the next build packages only what changed since it. The card shows the fallback baseline, the latest published version, and each environment's baseline. For a source, unlocked, or data package the baseline is history only — those types always build in full, and the pipeline advances it as the package moves through environments.

### Editing a baseline

A project owner can override a **diff package's** baseline: on the **Package Baseline** card, **Edit Baselines** opens a dialog to point the fallback, or a specific environment's baseline, at a commit on the branch — everything after it lands in the next diff build. Other package types cannot be edited here. For how diff packages and baselines work in detail, see [Diff Package](https://docs.flxbl.io/flxbl/sfp/concepts/supported-package-types/diff-package).

<figure><img src="/files/JZ5ubdLAIkPXO0rHoMCk" alt="The Edit Package Baselines dialog, showing the target to edit — fallback default or a named environment — and a field for the full commit SHA to compare against"><figcaption><p>Edit Package Baselines — pick the fallback or a specific environment, then set the commit its next diff build compares against.</p></figcaption></figure>

## AI insight reports

The **Insight** tab holds an AI-generated analysis of the selected package or domain: an executive summary and health assessment, followed by sections on overview, architecture, dependencies and relationships, and quality. The report is grounded in the repository — the analysis reads the actual source and git history of the scope it covers.

<figure><img src="/files/9ddxcGvuYpz71t6r9Jn6" alt="A package insight report showing an overall health score with executive summary, table of contents, and the report metadata chips for commit, age, duration, and model"><figcaption><p>A package insight — health score, executive summary, and section-by-section analysis.</p></figcaption></figure>

Reports are generated **only when you ask**: click **Generate Insight** (or **Regenerate** on an existing report) and the analysis runs in the background — a few minutes for a package, longer for a domain. Each report carries the commit it analysed, when it ran, how long it took, and the model that produced it. Requesting a report when one already exists for the current commit does nothing — codev tells you the report is up to date, and one analysis runs per scope at a time.

{% hint style="info" %}
Insight reports require an AI provider — configure one under **Settings > Integrations > AI Providers**. See [AI Providers](/flxbl/codev/integrations/ai-providers.md).
{% endhint %}

Insight reports analyse the project's **main branch** regardless of the branch selected in the explorer — the branch selector scopes the trees, the code, and the analysis findings, not the AI reports.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.flxbl.io/flxbl/codev/development/workspace-explorer-web.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.