# 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: 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:

```
GET https://docs.paradime.io/app-help/concepts/dbt-fundamentals/configuring-your-dbt-project.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.