The Clarinet JS SDK provides a powerful testing framework for Clarity smart contracts. It integrates with Vitest to let you run comprehensive tests against a simulated blockchain environment.
diff --git a/docs/reference/clarinet-js-sdk/unit-testing.md b/docs/build/clarinet-js-sdk/unit-testing.md
similarity index 100%
rename from docs/reference/clarinet-js-sdk/unit-testing.md
rename to docs/build/clarinet-js-sdk/unit-testing.md
diff --git a/docs/reference/clarinet/clarity-formatter.md b/docs/build/clarinet/clarity-formatter.md
similarity index 100%
rename from docs/reference/clarinet/clarity-formatter.md
rename to docs/build/clarinet/clarity-formatter.md
diff --git a/docs/reference/clarinet/contract-deployment.md b/docs/build/clarinet/contract-deployment.md
similarity index 100%
rename from docs/reference/clarinet/contract-deployment.md
rename to docs/build/clarinet/contract-deployment.md
diff --git a/docs/reference/clarinet/contract-interaction.md b/docs/build/clarinet/contract-interaction.md
similarity index 99%
rename from docs/reference/clarinet/contract-interaction.md
rename to docs/build/clarinet/contract-interaction.md
index f48648fa6e..1ef37e7165 100644
--- a/docs/reference/clarinet/contract-interaction.md
+++ b/docs/build/clarinet/contract-interaction.md
@@ -122,7 +122,7 @@ Advance the chain to test time-dependent logic:
> **Tip: Console reference**
>
-> For a complete list of console commands, see the [CLI reference](cli-reference.md).
+> For a complete list of console commands, see the [CLI reference](../../reference/clarinet/cli-reference.md).
## Common issues
diff --git a/docs/reference/clarinet/faq.md b/docs/build/clarinet/faq.md
similarity index 100%
rename from docs/reference/clarinet/faq.md
rename to docs/build/clarinet/faq.md
diff --git a/docs/reference/clarinet/local-blockchain-development.md b/docs/build/clarinet/local-blockchain-development.md
similarity index 100%
rename from docs/reference/clarinet/local-blockchain-development.md
rename to docs/build/clarinet/local-blockchain-development.md
diff --git a/docs/reference/clarinet/overview.md b/docs/build/clarinet/overview.md
similarity index 90%
rename from docs/reference/clarinet/overview.md
rename to docs/build/clarinet/overview.md
index 484c25bac9..61c6fa9873 100644
--- a/docs/reference/clarinet/overview.md
+++ b/docs/build/clarinet/overview.md
@@ -8,11 +8,11 @@ description: >-
Clarinet is the fastest way to build, test, and deploy smart contracts on the Stacks blockchain. It gives you a local devnet, REPL, testing framework, and debugging tools to ship high-quality Clarity code with confidence.
-
+
## Key features
-* [**Leverage a powerful CLI**](cli-reference.md) - Create new projects, manage your smart contracts and their dependencies using clarinet requirements, and interact with your code through the built-in REPL.
+* [**Leverage a powerful CLI**](../../reference/clarinet/cli-reference.md) - Create new projects, manage your smart contracts and their dependencies using clarinet requirements, and interact with your code through the built-in REPL.
* [**Write unit tests with the SDK**](../clarinet-js-sdk/unit-testing.md) - Use the Clarinet SDK to write unit tests in a familiar JS environment and validate contract behavior.
* [**Run a private blockchain environment**](local-blockchain-development.md) - Spin up a local devnet with nodes, miners, and APIs so you can test and integrate your code.
* [**VSCode extension**](../clarinet-integrations/vscode-extension.md) - Linter, step by step debugger, helps writing smart contracts (autocompletion, documentation etc).
diff --git a/docs/reference/clarinet/project-development.md b/docs/build/clarinet/project-development.md
similarity index 100%
rename from docs/reference/clarinet/project-development.md
rename to docs/build/clarinet/project-development.md
diff --git a/docs/reference/clarinet/project-structure.md b/docs/build/clarinet/project-structure.md
similarity index 100%
rename from docs/reference/clarinet/project-structure.md
rename to docs/build/clarinet/project-structure.md
diff --git a/docs/reference/clarinet/quickstart.md b/docs/build/clarinet/quickstart.md
similarity index 100%
rename from docs/reference/clarinet/quickstart.md
rename to docs/build/clarinet/quickstart.md
diff --git a/docs/reference/clarinet/validation-and-analysis.md b/docs/build/clarinet/validation-and-analysis.md
similarity index 100%
rename from docs/reference/clarinet/validation-and-analysis.md
rename to docs/build/clarinet/validation-and-analysis.md
diff --git a/docs/reference/post-conditions/implementing-post-conditions.md b/docs/build/post-conditions/implementing-post-conditions.md
similarity index 100%
rename from docs/reference/post-conditions/implementing-post-conditions.md
rename to docs/build/post-conditions/implementing-post-conditions.md
diff --git a/docs/reference/post-conditions/overview.md b/docs/build/post-conditions/overview.md
similarity index 100%
rename from docs/reference/post-conditions/overview.md
rename to docs/build/post-conditions/overview.md
diff --git a/docs/reference/stacks-connect/broadcast-transactions.md b/docs/build/stacks-connect/broadcast-transactions.md
similarity index 100%
rename from docs/reference/stacks-connect/broadcast-transactions.md
rename to docs/build/stacks-connect/broadcast-transactions.md
diff --git a/docs/reference/stacks-connect/connect-wallet.md b/docs/build/stacks-connect/connect-wallet.md
similarity index 100%
rename from docs/reference/stacks-connect/connect-wallet.md
rename to docs/build/stacks-connect/connect-wallet.md
diff --git a/docs/reference/stacks-connect/message-signing.md b/docs/build/stacks-connect/message-signing.md
similarity index 100%
rename from docs/reference/stacks-connect/message-signing.md
rename to docs/build/stacks-connect/message-signing.md
diff --git a/docs/reference/stacks-connect/migration-guide.md b/docs/build/stacks-connect/migration-guide.md
similarity index 100%
rename from docs/reference/stacks-connect/migration-guide.md
rename to docs/build/stacks-connect/migration-guide.md
diff --git a/docs/reference/stacks-connect/wallet-support.md b/docs/build/stacks-connect/wallet-support.md
similarity index 100%
rename from docs/reference/stacks-connect/wallet-support.md
rename to docs/build/stacks-connect/wallet-support.md
diff --git a/docs/reference/stacks.js-integrations/pyth-oracle-integration.md b/docs/build/stacks.js-integrations/pyth-oracle-integration.md
similarity index 100%
rename from docs/reference/stacks.js-integrations/pyth-oracle-integration.md
rename to docs/build/stacks.js-integrations/pyth-oracle-integration.md
diff --git a/docs/reference/stacks.js-integrations/react-native-integration.md b/docs/build/stacks.js-integrations/react-native-integration.md
similarity index 100%
rename from docs/reference/stacks.js-integrations/react-native-integration.md
rename to docs/build/stacks.js-integrations/react-native-integration.md
diff --git a/docs/reference/stacks.js/accounts-and-addresses.md b/docs/build/stacks.js/accounts-and-addresses.md
similarity index 100%
rename from docs/reference/stacks.js/accounts-and-addresses.md
rename to docs/build/stacks.js/accounts-and-addresses.md
diff --git a/docs/reference/stacks.js/address-validation.md b/docs/build/stacks.js/address-validation.md
similarity index 100%
rename from docs/reference/stacks.js/address-validation.md
rename to docs/build/stacks.js/address-validation.md
diff --git a/docs/reference/stacks.js/build-transactions.md b/docs/build/stacks.js/build-transactions.md
similarity index 100%
rename from docs/reference/stacks.js/build-transactions.md
rename to docs/build/stacks.js/build-transactions.md
diff --git a/docs/reference/stacks.js/contract-calls.md b/docs/build/stacks.js/contract-calls.md
similarity index 100%
rename from docs/reference/stacks.js/contract-calls.md
rename to docs/build/stacks.js/contract-calls.md
diff --git a/docs/reference/stacks.js/contract-deployment.md b/docs/build/stacks.js/contract-deployment.md
similarity index 100%
rename from docs/reference/stacks.js/contract-deployment.md
rename to docs/build/stacks.js/contract-deployment.md
diff --git a/docs/reference/stacks.js/encoding-and-decoding.md b/docs/build/stacks.js/encoding-and-decoding.md
similarity index 100%
rename from docs/reference/stacks.js/encoding-and-decoding.md
rename to docs/build/stacks.js/encoding-and-decoding.md
diff --git a/docs/reference/stacks.js/network-configuration.md b/docs/build/stacks.js/network-configuration.md
similarity index 100%
rename from docs/reference/stacks.js/network-configuration.md
rename to docs/build/stacks.js/network-configuration.md
diff --git a/docs/reference/stacks.js/networks.md b/docs/build/stacks.js/networks.md
similarity index 94%
rename from docs/reference/stacks.js/networks.md
rename to docs/build/stacks.js/networks.md
index 71e1e69ceb..c2faabd293 100644
--- a/docs/reference/stacks.js/networks.md
+++ b/docs/build/stacks.js/networks.md
@@ -4,7 +4,7 @@ Typically, we speak of `mainnet` and `testnet` as the networks of Stacks. Most w
As the name suggests, `testnet` is a public network for testing. It's a separate blockchain state that holds test tokens, which have no value.
-For completeness we also mention `devnet`. This isn't "one" network, but how developers refer to ephemeral local networks used for testing. It is the same as `testnet`, but for local development. [Learn more](../clarinet/local-blockchain-development.md).
+For completeness we also mention `devnet`. This isn't "one" network, but how developers refer to ephemeral local networks used for testing. It is the same as `testnet`, but for local development. [Learn more](../../build/clarinet/local-blockchain-development.md).
## Setting the network
diff --git a/docs/reference/stacks.js/overview.md b/docs/build/stacks.js/overview.md
similarity index 89%
rename from docs/reference/stacks.js/overview.md
rename to docs/build/stacks.js/overview.md
index 993910ca03..9ffa2b686c 100644
--- a/docs/reference/stacks.js/overview.md
+++ b/docs/build/stacks.js/overview.md
@@ -1,6 +1,6 @@
# Overview
-
 (1).png)
.png)
.png)
