> ## Documentation Index
> Fetch the complete documentation index at: https://lightdash-refactor-full-audit-reorg.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Build your semantic layer

> The developer track: install the CLI, add Tables, and define metrics and dimensions so your whole team can explore trusted data.

This track is for people who build in Lightdash. Everything you expose for BI is written as code in your dbt project, so the developer journey runs through the Lightdash CLI: you generate Tables from your models, then define the metrics and dimensions your team explores.

Start by [installing the CLI](/workflow/cli/install) and [logging in](/workflow/cli/authenticate). If you want to build conversationally with an AI coding agent, [install the Lightdash skills](/get-started/build-your-semantic-layer/install-skills) too. From there, work through the core steps below in order: [add Tables to Lightdash](/get-started/build-your-semantic-layer/add-tables-to-lightdash), then [create dimensions](/get-started/build-your-semantic-layer/create-dimensions) and [create metrics](/get-started/build-your-semantic-layer/create-metrics).

As your project grows, the rest of the [Workflow](/workflow) area picks up the lifecycle around it: [preview changes](/workflow/preview-projects) in an isolated project, [deploy](/workflow/cli/deploy) them to production, and [automate deploys with CI/CD](/workflow/set-up-ci-cd).

<Note>
  **Tag the dbt models you want to appear in Lightdash.** Before you start, add a `lightdash` (or similar) tag to the dbt models you want to expose as Tables, then set your project's [Table Configuration](/get-started/build-your-semantic-layer/add-tables-to-lightdash#configuring-which-tables-appear-in-your-lightdash-project) to match. This keeps staging and intermediate models out of Lightdash and makes your project easier to navigate.
</Note>

Prefer to watch first? This overview walks through the Lightdash developer workflow end to end.

<Frame>
  <iframe width="100%" height="420" src="https://www.loom.com/embed/09b65e2d8d984d15985002a49a832f57" frameborder="0" webkitallowfullscreen mozallowfullscreen allowfullscreen />
</Frame>
