> ## Documentation Index
> Fetch the complete documentation index at: https://docs.builderbox.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Component Library & Usage

***

> **Component Structure:**
>
> * Most landing and feature components are in `@/features` (e.g., `@/features/home/`, `@/features/content/`).
> * General-purpose, UI, and utility components are in `ui/` (e.g., `ui/button`, `ui/card`).
> * Usecase Based Components are in `@/components/` (e.g., `pricing-selector`, `testimonialscarousel`).

***

## Home/Landing Components (`@/features/home`)

### Hero Sections

<img className="block dark:hidden" src="https://mintcdn.com/humanoidz-57d637b0/FFfq-FJlkqH24DAo/images/frontend/hero1-dark.png?fit=max&auto=format&n=FFfq-FJlkqH24DAo&q=85&s=1d777e2207c32249c17919bd382b42e5" alt="Hero Light" width="1384" height="857" data-path="images/frontend/hero1-dark.png" />

<img className="hidden dark:block" src="https://mintcdn.com/humanoidz-57d637b0/FFfq-FJlkqH24DAo/images/frontend/hero1-dark.png?fit=max&auto=format&n=FFfq-FJlkqH24DAo&q=85&s=1d777e2207c32249c17919bd382b42e5" alt="Hero Dark" width="1384" height="857" data-path="images/frontend/hero1-dark.png" />

```tsx theme={null}
import Hero from "@/features/home/hero1";
<Hero />
```

### Navigation

<img className="block dark:hidden" src="https://mintcdn.com/humanoidz-57d637b0/FFfq-FJlkqH24DAo/images/frontend/navigation1-light.png?fit=max&auto=format&n=FFfq-FJlkqH24DAo&q=85&s=b1c9aa6614db19db088899fb0d657778" alt="Hero Light" width="1751" height="112" data-path="images/frontend/navigation1-light.png" />

<img className="hidden dark:block" src="https://mintcdn.com/humanoidz-57d637b0/FFfq-FJlkqH24DAo/images/frontend/navigation1-dark.png?fit=max&auto=format&n=FFfq-FJlkqH24DAo&q=85&s=e34db21cb098c9af0d51a00f76ef0dd6" alt="Hero Dark" width="1725" height="92" data-path="images/frontend/navigation1-dark.png" />

```tsx theme={null}
import Navigation from "@/features/home/navigation1";
<Navigation />
```

### Features

<img className="block dark:hidden" src="https://mintcdn.com/humanoidz-57d637b0/FFfq-FJlkqH24DAo/images/frontend/features1-light.png?fit=max&auto=format&n=FFfq-FJlkqH24DAo&q=85&s=8fa8f29eca610c41ee60f3b5e0a9d558" alt="Hero Light" width="1311" height="916" data-path="images/frontend/features1-light.png" />

<img className="hidden dark:block" src="https://mintcdn.com/humanoidz-57d637b0/FFfq-FJlkqH24DAo/images/frontend/features1-dark.png?fit=max&auto=format&n=FFfq-FJlkqH24DAo&q=85&s=7b65ccb1bf8217177600d88885433b20" alt="Hero Dark" width="1559" height="894" data-path="images/frontend/features1-dark.png" />

```tsx theme={null}
import Features from "@/features/home/features1";
<Features />
```

### Stats

<img className="block dark:hidden" src="https://mintcdn.com/humanoidz-57d637b0/FFfq-FJlkqH24DAo/images/frontend/stats1-light.png?fit=max&auto=format&n=FFfq-FJlkqH24DAo&q=85&s=cf4fb23af3995d691e79f3f6ef50fc25" alt="Hero Light" width="1184" height="441" data-path="images/frontend/stats1-light.png" />

<img className="hidden dark:block" src="https://mintcdn.com/humanoidz-57d637b0/FFfq-FJlkqH24DAo/images/frontend/stats1-dark.png?fit=max&auto=format&n=FFfq-FJlkqH24DAo&q=85&s=abfa754c2246921f0cf369327787254c" alt="Hero Dark" width="1184" height="441" data-path="images/frontend/stats1-dark.png" />

```tsx theme={null}
import Stats from "@/features/home/stats1";
<Stats />
```

### Testimonials

<img className="block dark:hidden" src="https://mintcdn.com/humanoidz-57d637b0/FFfq-FJlkqH24DAo/images/frontend/testimonials1-light.png?fit=max&auto=format&n=FFfq-FJlkqH24DAo&q=85&s=809254a342bbdd25be1f84e23f5b991e" alt="Hero Light" width="1461" height="935" data-path="images/frontend/testimonials1-light.png" />

<img className="hidden dark:block" src="https://mintcdn.com/humanoidz-57d637b0/FFfq-FJlkqH24DAo/images/frontend/testimonials1-dark.png?fit=max&auto=format&n=FFfq-FJlkqH24DAo&q=85&s=98798c71a5193bb44b823de400327e8b" alt="Hero Dark" width="1422" height="863" data-path="images/frontend/testimonials1-dark.png" />

```tsx theme={null}
import Testimonials from "@/features/home/testimonials1";
<Testimonials />
```

### Pricing

<img className="block dark:hidden" src="https://mintcdn.com/humanoidz-57d637b0/FFfq-FJlkqH24DAo/images/frontend/pricing1-light.png?fit=max&auto=format&n=FFfq-FJlkqH24DAo&q=85&s=605677c3e169dd2f7afb6c05af11bfdc" alt="Hero Light" width="1461" height="935" data-path="images/frontend/pricing1-light.png" />

<img className="hidden dark:block" src="https://mintcdn.com/humanoidz-57d637b0/FFfq-FJlkqH24DAo/images/frontend/pricing1-dark.png?fit=max&auto=format&n=FFfq-FJlkqH24DAo&q=85&s=243bc3bafbeca17ad3e5e9d4434b399a" alt="Hero Dark" width="1461" height="935" data-path="images/frontend/pricing1-dark.png" />

```tsx theme={null}
import { Pricing } from "@/features/home/shared/pricing";
<Pricing />
```

### Call to Action

<img className="block dark:hidden" src="https://mintcdn.com/humanoidz-57d637b0/FFfq-FJlkqH24DAo/images/frontend/cta1-light.png?fit=max&auto=format&n=FFfq-FJlkqH24DAo&q=85&s=a53af3034424d04348f33728ba7e0969" alt="Hero Light" width="1272" height="408" data-path="images/frontend/cta1-light.png" />

<img className="hidden dark:block" src="https://mintcdn.com/humanoidz-57d637b0/FFfq-FJlkqH24DAo/images/frontend/cta1-dark.png?fit=max&auto=format&n=FFfq-FJlkqH24DAo&q=85&s=897461706f87290b4a9a56d3e6f6b91b" alt="Hero Dark" width="1372" height="409" data-path="images/frontend/cta1-dark.png" />

```tsx theme={null}
import CallToAction from "@/features/home/call-to-action1";
<CallToAction />
```

### Contact

<img className="block dark:hidden" src="https://mintlify.s3.us-west-1.amazonaws.com/humanoidz-57d637b0/images/frontend/1-light.png" alt="Contact" />

<img className="hidden dark:block" src="https://mintlify.s3.us-west-1.amazonaws.com/humanoidz-57d637b0/images/frontend/1-dark.png" alt="Contact" />

```tsx theme={null}
import Contact from "@/features/home/contact1";
<Contact />
```

### Footer

<img className="block dark:hidden" src="https://mintcdn.com/humanoidz-57d637b0/FFfq-FJlkqH24DAo/images/frontend/footer1-light.png?fit=max&auto=format&n=FFfq-FJlkqH24DAo&q=85&s=5bd82cd25d104ab9bcebe19213a21e27" alt="Footer" width="1272" height="408" data-path="images/frontend/footer1-light.png" />

<img className="hidden dark:block" src="https://mintcdn.com/humanoidz-57d637b0/FFfq-FJlkqH24DAo/images/frontend/footer1-dark.png?fit=max&auto=format&n=FFfq-FJlkqH24DAo&q=85&s=9ccb969775f9d3c50208c63a3005057e" alt="Footer" width="1272" height="408" data-path="images/frontend/footer1-dark.png" />

```tsx theme={null}
import Footer from "@/features/home/footer1";
<Footer />
```

### Bento Grid

<img className="block dark:hidden" src="https://mintcdn.com/humanoidz-57d637b0/FFfq-FJlkqH24DAo/images/frontend/bentogrid2-light.png?fit=max&auto=format&n=FFfq-FJlkqH24DAo&q=85&s=84dd3ec876de718a6a9773f6e5af8bc8" alt="Hero Light" width="1392" height="924" data-path="images/frontend/bentogrid2-light.png" />

<img className="hidden dark:block" src="https://mintcdn.com/humanoidz-57d637b0/FFfq-FJlkqH24DAo/images/frontend/bentogrid1-dark.png?fit=max&auto=format&n=FFfq-FJlkqH24DAo&q=85&s=3ad2912e203f8406ffe906569bf9e561" alt="Hero Dark" width="1310" height="931" data-path="images/frontend/bentogrid1-dark.png" />

```tsx theme={null}
import BentoGrid from "@/features/home/bento-grid1";
<BentoGrid />
```

### FAQs

<img className="block dark:hidden" src="https://mintcdn.com/humanoidz-57d637b0/FFfq-FJlkqH24DAo/images/frontend/faqs1-light.png?fit=max&auto=format&n=FFfq-FJlkqH24DAo&q=85&s=d8715c2e0215126b30a278001f66ab9d" alt="Hero Light" width="903" height="673" data-path="images/frontend/faqs1-light.png" />

<img className="hidden dark:block" src="https://mintcdn.com/humanoidz-57d637b0/FFfq-FJlkqH24DAo/images/frontend/faqs1-dark.png?fit=max&auto=format&n=FFfq-FJlkqH24DAo&q=85&s=b451f19b2274d26da52b6fe84623447b" alt="Hero Dark" width="804" height="598" data-path="images/frontend/faqs1-dark.png" />

```tsx theme={null}
import FAQs from "@/features/home/faqs1";
<FAQs />
```

### Logos

<img className="block dark:hidden" src="https://mintlify.s3.us-west-1.amazonaws.com/humanoidz-57d637b0/images/frontend/loogs1-light.png" alt="Logos" />

<img className="hidden dark:block" src="https://mintlify.s3.us-west-1.amazonaws.com/humanoidz-57d637b0/images/frontend/loogs1-dark.png" alt="Logos" />

```tsx theme={null}
import Logos from "@/features/home/logos2";
<Logos />
```

***

## General & UI Components (`ui/`)

* **UI Primitives:** All components in `ui/` (e.g., `button`, `input`, `card`, `dialog`, `dropdown-menu`, `tabs`, `table`, `badge`, `avatar`, etc.)

**Usage Example:**

```tsx theme={null}
import { Button } from "ui/button";
<Button variant="outline">Click me</Button>
```

***

## Top-Level Components & Usage

Below are usage examples for each top-level component (not in `ui/` or any subfolder), organized by use case. Each component preview image appears before its code example.

***

### Testimonials Components

#### TestimonialsSingle

<img className="block " src="https://mintcdn.com/humanoidz-57d637b0/FFfq-FJlkqH24DAo/images/frontend/testimonialssingle.png?fit=max&auto=format&n=FFfq-FJlkqH24DAo&q=85&s=336ef30ec3584279eb46216cc481430f" alt="TestimonialsSingle Light" width="849" height="408" data-path="images/frontend/testimonialssingle.png" />

```tsx theme={null}
import TestimonialsSingle from "@/components/testimonials-single";
<TestimonialsSingle />
```

#### TestimonialsCarousel

<img className="block " src="https://mintcdn.com/humanoidz-57d637b0/FFfq-FJlkqH24DAo/images/frontend/testimonialscarousel.png?fit=max&auto=format&n=FFfq-FJlkqH24DAo&q=85&s=e30060f49926ecc3cea72042ab0e8dbe" alt="TestimonialsSingle Light" width="853" height="322" data-path="images/frontend/testimonialscarousel.png" />

```tsx theme={null}
import { TestimonialsCarousel } from "@/components/testimonials-carousel";
<TestimonialsCarousel />
```

#### TestimonialsAnimated

<img className="block " src="https://mintcdn.com/humanoidz-57d637b0/FFfq-FJlkqH24DAo/images/frontend/testimonialsanimated.png?fit=max&auto=format&n=FFfq-FJlkqH24DAo&q=85&s=07d83aabd66bf5bab9c196afbb82a01e" alt="TestimonialsSingle Light" width="950" height="433" data-path="images/frontend/testimonialsanimated.png" />

```tsx theme={null}
import AnimatedTestimonialsDemo from "@/components/testimonials-animated";
<AnimatedTestimonialsDemo />
```

#### TestimonialSingle

<img className="block " src="https://mintcdn.com/humanoidz-57d637b0/FFfq-FJlkqH24DAo/images/frontend/testimonialsingle.png?fit=max&auto=format&n=FFfq-FJlkqH24DAo&q=85&s=22f18bbe68a32632998f0b6e6b011b62" alt="TestimonialsSingle Light" width="582" height="401" data-path="images/frontend/testimonialsingle.png" />

```tsx theme={null}
import { TestimonialSingle } from "@/components/testimonial-single";
<TestimonialSingle />
```

#### TestimonialGrid

<img className="block " src="https://mintcdn.com/humanoidz-57d637b0/FFfq-FJlkqH24DAo/images/frontend/testimonialsgrid.png?fit=max&auto=format&n=FFfq-FJlkqH24DAo&q=85&s=938a5cda6fd13441ccc7333b221fde37" alt="TestimonialsSingle Light" width="947" height="375" data-path="images/frontend/testimonialsgrid.png" />

```tsx theme={null}
import { TestimonialGrid } from "@/components/testimonial-grid";
<TestimonialGrid />
```

***

### Pricing Components

#### PricingSelector

<img className="block " src="https://mintcdn.com/humanoidz-57d637b0/FFfq-FJlkqH24DAo/images/frontend/pricingselector.png?fit=max&auto=format&n=FFfq-FJlkqH24DAo&q=85&s=39d9cb8dbe1c3c564140de0997724258" alt="TestimonialsSingle Light" width="1016" height="562" data-path="images/frontend/pricingselector.png" />

```tsx theme={null}
import { PricingSelector } from "@/components/pricing-selector";
<PricingSelector />
```

#### PricingWithModals

<img className="block " src="https://mintcdn.com/humanoidz-57d637b0/FFfq-FJlkqH24DAo/images/frontend/simplepricing.png?fit=max&auto=format&n=FFfq-FJlkqH24DAo&q=85&s=2b39c3e284761629de629076b63483c4" alt="TestimonialsSingle Light" width="996" height="920" data-path="images/frontend/simplepricing.png" />

```tsx theme={null}
import PricingPage from "@/components/pricing-with-modals";
<PricingPage />
```

#### SimplePricing

<img className="block " src="https://mintcdn.com/humanoidz-57d637b0/FFfq-FJlkqH24DAo/images/frontend/simplepricing.png?fit=max&auto=format&n=FFfq-FJlkqH24DAo&q=85&s=2b39c3e284761629de629076b63483c4" alt="TestimonialsSingle Light" width="996" height="920" data-path="images/frontend/simplepricing.png" />

```tsx theme={null}
import SimplePricing from "@/components/pricing copy";
<SimplePricing />
```

***

### Feature/Content Components

#### FeatureGrid

<img className="block " src="https://mintcdn.com/humanoidz-57d637b0/FFfq-FJlkqH24DAo/images/frontend/featuregrid.png?fit=max&auto=format&n=FFfq-FJlkqH24DAo&q=85&s=91003e574cb8ba6fa17a6d1f6d39f113" alt="TestimonialsSingle Light" width="865" height="236" data-path="images/frontend/featuregrid.png" />

```tsx theme={null}
import { FeatureGrid } from "@/components/feature-grid";
<FeatureGrid />
```

#### FeaturesCirculated

<img className="block " src="https://mintcdn.com/humanoidz-57d637b0/FFfq-FJlkqH24DAo/images/frontend/featurescirculated.png?fit=max&auto=format&n=FFfq-FJlkqH24DAo&q=85&s=3dfc4c9970444f6d2ea8998df6763580" alt="TestimonialsSingle Light" width="963" height="760" data-path="images/frontend/featurescirculated.png" />

```tsx theme={null}
import Feature3 from "@/components/features-circulated";
<Feature3 />
```

#### FeaturesBentoGrid

<img className="block " src="https://mintcdn.com/humanoidz-57d637b0/FFfq-FJlkqH24DAo/images/frontend/featuresbentogrid.png?fit=max&auto=format&n=FFfq-FJlkqH24DAo&q=85&s=c19dbbaa4428dea54ec61b5a60f6f387" alt="TestimonialsSingle Light" width="1071" height="865" data-path="images/frontend/featuresbentogrid.png" />

```tsx theme={null}
import BentoGrid from "@/components/features-bento-grid";
<BentoGrid />
```

#### FeaturesAccordion

<img className="block " src="https://mintcdn.com/humanoidz-57d637b0/FFfq-FJlkqH24DAo/images/frontend/featuresaccordion.png?fit=max&auto=format&n=FFfq-FJlkqH24DAo&q=85&s=1267f91f3479d96f3ac0575e15c8f7ea" alt="TestimonialsSingle Light" width="898" height="802" data-path="images/frontend/featuresaccordion.png" />

```tsx theme={null}
import FeatureSteps from "@/components/features-accordion";
<FeatureSteps />
```

***

### Navigation & Layout Components

#### NavProjects

<img className="block " src="https://mintcdn.com/humanoidz-57d637b0/FFfq-FJlkqH24DAo/images/frontend/header.png?fit=max&auto=format&n=FFfq-FJlkqH24DAo&q=85&s=af34e9cee35fa81eca0f5224e96836d6" alt="TestimonialsSingle Light" width="1437" height="69" data-path="images/frontend/header.png" />

```tsx theme={null}
import Header from "@/components/header";
<Header />
```

#### Footer

<img className="block " src="https://mintcdn.com/humanoidz-57d637b0/FFfq-FJlkqH24DAo/images/frontend/footer.png?fit=max&auto=format&n=FFfq-FJlkqH24DAo&q=85&s=e4bf6ffe87521d3db16fcced784ae087" alt="TestimonialsSingle Light" width="987" height="484" data-path="images/frontend/footer.png" />

```tsx theme={null}
import Footer from "@/components/footer";
<Footer />
```

***

#### UsageDashboard

<img className="block " src="https://mintcdn.com/humanoidz-57d637b0/FFfq-FJlkqH24DAo/images/frontend/usagedashboard.png?fit=max&auto=format&n=FFfq-FJlkqH24DAo&q=85&s=eb6438f0521ba14df56510df709aeb1e" alt="TestimonialsSingle Light" width="1034" height="623" data-path="images/frontend/usagedashboard.png" />

```tsx theme={null}
import UsageDashboard from "@/components/team-switcher";
<UsageDashboard />
```

#### UsageMeter

<img className="block " src="https://mintcdn.com/humanoidz-57d637b0/FFfq-FJlkqH24DAo/images/frontend/usemeter.png?fit=max&auto=format&n=FFfq-FJlkqH24DAo&q=85&s=1e124629ecd6e04a1c0bb932c856431c" alt="Use Meter" width="573" height="124" data-path="images/frontend/usemeter.png" />

```tsx theme={null}
import { UsageMeter } from "@/components/usage-meter";
<UsageMeter value={75} label="API Usage" quota="750/1000" />
```

***

### AI & Prompt Components

#### AIConversation

<img className="block " src="https://mintcdn.com/humanoidz-57d637b0/FFfq-FJlkqH24DAo/images/frontend/aiconversation.png?fit=max&auto=format&n=FFfq-FJlkqH24DAo&q=85&s=c85049811e4bce35b32bda4945cd93be" alt="TestimonialsSingle Light" width="832" height="813" data-path="images/frontend/aiconversation.png" />

```tsx theme={null}
import AIConversation from "@/components/ai-conversation";
<AIConversation />
```

#### AIAnimatedChat

<img className="block " src="https://mintcdn.com/humanoidz-57d637b0/FFfq-FJlkqH24DAo/images/frontend/aianimatedchat.png?fit=max&auto=format&n=FFfq-FJlkqH24DAo&q=85&s=84364375c9f7c12a3857f724e9b31fbb" alt="TestimonialsSingle Light" width="860" height="527" data-path="images/frontend/aianimatedchat.png" />

```tsx theme={null}
import AIAnimatedChat from "@/components/ai-animated-chat";
<AnimatedAIChat />
```

#### PromptInput

<img className="block " src="https://mintcdn.com/humanoidz-57d637b0/FFfq-FJlkqH24DAo/images/frontend/promptinput.png?fit=max&auto=format&n=FFfq-FJlkqH24DAo&q=85&s=320a3f2315210f392567dd21831e9dd8" alt="TestimonialsSingle Light" width="993" height="201" data-path="images/frontend/promptinput.png" />

```tsx theme={null}
import AIConversation from "@/components/ai-conversation";
<PromptInput maxTokens={100} onSubmit={val => alert(val)} />
```

#### ResponseStream

<img className="block " src="https://mintcdn.com/humanoidz-57d637b0/FFfq-FJlkqH24DAo/images/frontend/responsestream.png?fit=max&auto=format&n=FFfq-FJlkqH24DAo&q=85&s=23e5a661e52694cf517b035d05e299ee" alt="TestimonialsSingle Light" width="1013" height="170" data-path="images/frontend/responsestream.png" />

```tsx theme={null}
import { ResponseStream } from "@/components/response-stream";

<ResponseStream response="Hello, world!" isStreaming />
```

***

### Utility & Miscellaneous Components

#### ButtonLead

```tsx theme={null}
import { ButtonLead } from "@/components/button-lead";
<ButtonLead label="Join Now" />
```

#### Loader

```tsx theme={null}
import Loader from "@/components/loader";
<Loader />
```

#### AppSidebar

```tsx theme={null}
import AppSidebar from "@/components/app-sidebar";
<AppSidebar />
```

#### Providers

```tsx theme={null}
import Providers from "@/components/providers";
<Providers>{children}</Providers>
```

***
