> For the complete documentation index, see [llms.txt](https://docs.paradime.io/app-help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.paradime.io/app-help/concepts/dbt-fundamentals/configuring-your-dbt-project.md).

# Configuring your dbt™ Project

Setting up a well-structured **dbt™ project** is essential for scalability, maintainability, and efficiency. This section covers the core configurations needed to define sources, manage transformations, and ensure data quality in your dbt™ workflows.

Whether you're starting from scratch or optimizing an existing setup, these guides will help you configure your dbt™ project effectively.

### Key Areas of Configuration

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td>📄 <strong>Setting Up Your dbt_project.yml</strong></td><td>Define project-wide configurations, including materializations, model directories, and environment settings.</td><td></td><td><a href="/pages/szCNwMvK0EcMzWcFj8Wi">/pages/szCNwMvK0EcMzWcFj8Wi</a></td><td></td></tr><tr><td>📊 <strong>Defining Your Sources</strong></td><td>Use <code>sources.yml</code> to document and reference external data sources in your transformations.</td><td></td><td><a href="/pages/kqwNSf5WeloUKjfDUU2r">/pages/kqwNSf5WeloUKjfDUU2r</a></td><td></td></tr><tr><td>🔄 <strong>Testing Source Freshness</strong></td><td>Ensure your raw data is up to date with automatic freshness checks in dbt™.</td><td></td><td><a href="/pages/f7WZmJpI4tZIE3vSU2Uk">/pages/f7WZmJpI4tZIE3vSU2Uk</a></td><td></td></tr><tr><td>🏷️ <strong>Working with Tags in Your dbt™ Project</strong></td><td>Organize and selectively run models using tags for better project structure and workflow control.</td><td></td><td><a href="/pages/634S2oxI9LrvAiufTxR4">/pages/634S2oxI9LrvAiufTxR4</a></td><td></td></tr><tr><td><strong>🧪 Unit Testing</strong></td><td>Validate your SQL transformation logic with controlled input data before deploying models.</td><td></td><td><a href="/pages/sJ9GhmaddDQ1J3M5woD4">/pages/sJ9GhmaddDQ1J3M5woD4</a></td><td></td></tr></tbody></table>

{% hint style="info" %}
Prefer hands-on learning? Check out our [**Paradime 101 Guide**](/app-help/guides/paradime-101.md) for a step-by-step, interactive way to learn dbt™ and analytics engineering best practices—all for free.
{% endhint %}


---

# 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.paradime.io/app-help/concepts/dbt-fundamentals/configuring-your-dbt-project.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.