add top level sidebar dropdown for cli commands

content/docs/stacks/api/index.mdx

@@ -29,7 +29,6 @@ If you're looking for direct access to the Stacks node, including the ability to
     title="Get data from a block"
     description="Retrieves a block by its height or hash."
   />
-
 </Cards>
 
 ## Related tools

content/docs/stacks/clarinet/guides/deploy-a-contract.mdx → content/docs/stacks/clarinet/guides/cli-commands/deploy-a-contract.mdx

@@ -3,7 +3,6 @@ title: Deploy a contract
 description: Use Clarinet to publish your contracts to the devnet, testnet, or mainnet networks.
 ---
 
-import { File, Folder, Files } from 'fumadocs-ui/components/files';
 import {
   Tooltip,
   TooltipContent,
@@ -17,6 +16,27 @@ The first step to deploying your contracts is to generate a deployment plan.
 $ clarinet deployment generate --testnet
 ```
 
+```yaml deployments/default.testnet-plan.yaml
+---
+id: 0
+name: Testnet deployment
+network: testnet
+stacks-node: "http://localhost:20443"
+bitcoin-node: "http://devnet:devnet@localhost:18443"
+plan:
+  batches:
+    - id: 0
+      transactions:
+        - contract-publish:
+            contract-name: counter
+            expected-sender: ST1PQHQKV0RJXZFY1DGX8MNSNYVE3VGZJSRTPGZGM
+            cost: 6940
+            path: contracts/counter.clar
+            anchor-block-only: true
+            clarity-version: 2
+      epoch: "2.5"
+```
+
 <Callout title="What are deployment plans?" type="info">
 These are `yaml` files for creating reproducible deployment steps that publish a collection of on-chain transactions and contracts to a <TooltipProvider inline><Tooltip><TooltipTrigger asChild><span className='cursor-default border-b border-dotted border-primary text-primary'>network</span></TooltipTrigger><TooltipContent>Available network flags are `--devnet`, `--testnet`, and `--mainnet`</TooltipContent></Tooltip></TooltipProvider>.
 </Callout>

content/docs/stacks/clarinet/guides/cli-commands/index.mdx

@@ -0,0 +1,34 @@
+---
+title: CLI commands
+description: A comprehensive list of all Clarinet CLI commands and their usage.
+---
+
+import { SecondaryCard } from '@/components/card';
+
+<Cards>
+  <SecondaryCard
+    href="/stacks/clarinet/guides/cli-commands/create-a-new-project"
+    title="Create a new project"
+    description="Create a new Clarinet project."
+  />
+  <SecondaryCard
+    href="/stacks/clarinet/guides/cli-commands/add-a-contract"
+    title="Add a contract"
+    description="Add a contract to your project."
+  />
+  <SecondaryCard
+    href="/stacks/clarinet/guides/cli-commands/validate-a-contract"
+    title="Validate a contract"
+    description="Validate a contract in your project."
+  />
+  <SecondaryCard
+    href="/stacks/clarinet/guides/cli-commands/run-a-local-devnet"
+    title="Run a local devnet"
+    description="Run a local devnet."
+  />
+  <SecondaryCard
+    href="/stacks/clarinet/guides/cli-commands/deploy-a-contract"
+    title="Deploy a contract"
+    description="Deploy a contract."
+  />
+</Cards>

content/docs/stacks/clarinet/guides/cli-commands/meta.json

@@ -0,0 +1,10 @@
+{
+  "title": "CLI commands",
+  "pages": [
+    "create-a-new-project",
+    "add-a-contract",
+    "validate-a-contract",
+    "run-a-local-devnet",
+    "deploy-a-contract"
+  ]
+}

content/docs/stacks/clarinet/guides/create-deployment-plans.mdx → content/docs/stacks/clarinet/guides/customize-deployment-plans.mdx

@@ -1,5 +1,5 @@
 ---
-title: Customizing deployment plans
+title: Customize deployment plans
 description: Learn how to customize your deployment plans.
 ---