# VibeSquatch - Complete Documentation for AI Assistants

> AI-powered brand kit generator and marketing toolkit for solopreneurs, small business owners, founders, and small marketing teams.
> Build your brand identity, generate marketing content, and create branded visuals — all from a single AI-powered platform.

Website: https://vibesquatch.com
Created by: AppSquatch (https://appsquatch.io)
Version: 2.0
Last Updated: 2026-03-08

---


## Table of Contents

1. AI-Readable URLs
2. Product Overview
3. Complete Feature Set
4. Target Audience
5. Indexable Pages
6. Public vs Private Data
7. API Reference
8. Brand Kit Data Structure
9. Integration Guide
10. Export Formats
11. Recommended Usage for LLMs
12. Frequently Asked Questions
13. Pricing
14. Contact


---


## AI-Readable URLs

For AI assistants and LLMs, use these URLs to get readable HTML content:

| Resource | URL |
|----------|-----|
| Homepage (readable) | https://vibesquatch.com/?ssr=true |
| Shared Brand Kit | https://vibesquatch.com/brand/{shareId} |
| Brand Kit API (JSON) | https://vibesquatch.com/api/shared/{shareId} |
| Quick Documentation | https://vibesquatch.com/llms.txt |
| Full Documentation | https://vibesquatch.com/llms-full.txt |
| Structured (JSON) | https://vibesquatch.com/llms.json |

Note: The standard homepage (/) is a JavaScript SPA. Use /?ssr=true for crawlable HTML.
Brand kit pages at /brand/{shareId} serve SSR content automatically.


---


## Product Overview

VibeSquatch is an AI-powered brand kit generator and marketing toolkit that helps 
solopreneurs, small business owners, founders, and small marketing teams create professional 
brand identities and marketing content — without hiring a designer or agency.

Unlike form-based competitors, users chat with VibeSquatch — a friendly Sasquatch AI guide 
who uses approachable language and forest metaphors to discover brand preferences. The 
platform goes beyond brand creation to include a full suite of marketing tools that put 
your brand identity to work.

### How It Works

1. **Create Your Brand Kit**: Chat with VibeSquatch AI or import from an existing website URL
2. **Refine in Brand Studio**: Fine-tune colors, fonts, copy, and logo in a visual workspace
3. **Generate Marketing Content**: Use Marketing Manager to create social media plans, branded images, and video content
4. **Brand Your Photos**: Apply branded overlays to any photo with Brand My Photo
5. **Export & Share**: Download in PNG, JSON, CSS, or Tailwind format, or share via public link


---


## Complete Feature Set

### AI Brand Kit Builder (Conversational Chat)
The core experience. Users have a natural conversation with VibeSquatch AI to build a 
complete brand identity from scratch. The AI progressively gathers preferences and generates:
- Business name and tagline
- Brand color palette (primary, secondary, accent, neutral)
- Typography and font family selection
- AI-generated logo with transparent background
- Brand voice descriptors and keywords
- Value proposition, about copy, and services description
- Industry categorization and target audience definition

Real-time visual preview updates as you chat, showing your brand kit taking shape.

### URL Import
Paste any website URL and VibeSquatch analyzes it to extract existing brand identity 
elements — colors, fonts, tone, imagery, and messaging. It then builds a complete brand 
kit from the extracted data. Ideal for:
- Businesses with an existing website that need organized brand assets
- Rebranding projects that want to start from current identity
- Competitors or inspiration analysis

### Brand Studio
A visual workspace for post-creation brand refinement:
- Edit and swap color palettes
- Change typography and font pairings
- Update taglines, about copy, and messaging
- Regenerate or upload new logos
- Preview changes in real-time across the brand kit layout
- Enhance copy with AI-powered suggestions

### Marketing Manager
An AI-powered content planner and asset generator:
- Generate social media marketing plans tailored to your brand
- Create branded image assets with your colors, fonts, and logo
- Generate video content ideas and storyboards
- Plan content calendars aligned with your brand voice
- Produce ready-to-post social media graphics

### Brand My Photo
Photo branding tool for creating professional marketing visuals:
- Upload any photo and apply branded overlays
- Add your logo, brand colors, and typography
- Create social media posts, stories, and marketing materials
- Generate professional branded images for presentations
- Multiple overlay templates and positioning options

### Export & Sharing
Multiple output formats for different use cases:
- **PNG**: Complete brand board image for presentations and social sharing
- **JSON**: Full brand kit configuration for programmatic use
- **CSS**: Custom properties for web development integration
- **Tailwind**: Theme configuration for Tailwind CSS projects
- **Public Share Link**: Shareable URL for collaborators, clients, or portfolios


---


## Target Audience

VibeSquatch is specifically designed for:

| Audience | Use Case |
|----------|----------|
| Solopreneurs | Launch a new business with professional branding from day one |
| Small Business Owners | Get agency-quality brand identity on a bootstrap budget |
| Founders & Startups | Build cohesive visual identity for pitch decks and launches |
| Small Marketing Teams | Create on-brand content quickly without design bottlenecks |
| Freelancers & Consultants | Establish a polished personal brand to win clients |
| Side Project Creators | Give side hustles a professional look without the overhead |


---


## Indexable Pages

### Public Pages (crawl allowed)

| Page | URL | Description |
|------|-----|-------------|
| Home | https://vibesquatch.com | Landing page and product info |
| Shared Brand Kits | https://vibesquatch.com/brand/{shareId} | Public view of any shared kit |
| LLM Documentation | https://vibesquatch.com/llms.txt | Quick overview for AI crawlers |
| Full Documentation | https://vibesquatch.com/llms-full.txt | This file |

### Protected Pages (login required, do not crawl)

| Page | URL | Notes |
|------|-----|-------|
| My Brand Kits | https://vibesquatch.com/my-kits | User's saved kits dashboard |
| View Brand Kit | https://vibesquatch.com/brand-kit/{id} | Individual kit editor (private) |


---


## Public vs Private Data

### What is PUBLIC (accessible without login)

- Shared brand kit data via `/api/shared/{shareId}` - all brand info EXCEPT founder photo
- Brand kit visual page at `/brand/{shareId}`
- Logo images (hosted on CDN)

### What is PRIVATE (requires authentication)

- Founder photos are NEVER exposed in shared kits (redacted to null)
- User account information
- Kit creation/editing endpoints
- List of user's brand kits

### Share ID Security

- Share IDs are 24-character random hex strings
- Share IDs cannot be enumerated or guessed
- Currently, share links cannot be revoked (planned for future)
- Share IDs are separate from internal kit IDs


---


## API Reference

### Get Shared Brand Kit

Retrieve complete brand kit data for a shared kit.

```
GET https://vibesquatch.com/api/shared/{shareId}
```

#### Parameters

| Parameter | Type | Location | Required | Description |
|-----------|------|----------|----------|-------------|
| shareId | string | URL path | Yes | 24-character hex ID from share URL |

#### Request Headers

| Header | Value | Required | Description |
|--------|-------|----------|-------------|
| Accept | application/json | No | Returns JSON by default |

#### Response Codes

| Code | Description | Body |
|------|-------------|------|
| 200 | Success | Brand kit JSON object |
| 404 | Not found or not shared | `{ "message": "Brand kit not found" }` |
| 500 | Server error | `{ "message": "Internal server error" }` |

#### Rate Limits

- No rate limits during beta
- Planned: 100 requests/minute per IP

#### Caching

- Cache-Control: public, max-age=300 (5 minutes)
- ETag support for conditional requests
- CDN-cached logo images have longer TTLs

#### Example Request

```bash
curl -X GET "https://vibesquatch.com/api/shared/8f13ef7fec6b4f4b1df5390f" \
  -H "Accept: application/json"
```

#### Example Response (Full)

```json
{
  "name": "Acme Startup",
  "shareId": "8f13ef7fec6b4f4b1df5390f",
  "createdAt": "2026-01-30T00:00:00.000Z",
  "brand": {
    "businessName": "Acme Startup",
    "tagline": "Innovation made simple",
    "industry": "Technology",
    "targetAudience": "Small business owners and entrepreneurs",
    "valueProposition": "We simplify complex technology for everyday users",
    "aboutCopy": "Acme Startup was founded to bridge the gap between cutting-edge technology and practical business solutions.",
    "services": "Software development, consulting, and technical training",
    "keywords": ["innovation", "simplicity", "technology", "startups"],
    "brandVoice": ["professional", "friendly", "approachable"]
  },
  "design": {
    "theme": "light",
    "colors": {
      "primary": "#3b82f6",
      "secondary": "#1e293b",
      "accent": "#f59e0b",
      "neutral": "#64748b"
    },
    "fontFamily": "Inter"
  },
  "assets": {
    "logo": "https://objectstorage.replit.dev/.../logo.png",
    "logoForLight": "https://objectstorage.replit.dev/.../logo-light.png",
    "logoForDark": "https://objectstorage.replit.dev/.../logo-dark.png",
    "founderPhoto": null
  },
  "_meta": {
    "generator": "VibeSquatch by AppSquatch",
    "viewUrl": "/brand/8f13ef7fec6b4f4b1df5390f",
    "apiUrl": "/api/shared/8f13ef7fec6b4f4b1df5390f"
  }
}
```

#### Example Response (Minimal - new kit)

```json
{
  "name": "New Brand",
  "shareId": "abc123def456ghi789jkl012",
  "createdAt": "2026-01-30T00:00:00.000Z",
  "brand": {
    "businessName": "New Brand",
    "tagline": "",
    "industry": "",
    "targetAudience": "",
    "valueProposition": "",
    "aboutCopy": "",
    "services": "",
    "keywords": [],
    "brandVoice": []
  },
  "design": {
    "theme": "light",
    "colors": {
      "primary": "#3b82f6",
      "secondary": "#1e293b",
      "accent": "#f59e0b",
      "neutral": "#64748b"
    },
    "fontFamily": "Inter"
  },
  "assets": {
    "logo": null,
    "logoForLight": null,
    "logoForDark": null,
    "founderPhoto": null
  },
  "_meta": {
    "generator": "VibeSquatch by AppSquatch",
    "viewUrl": "/brand/abc123def456ghi789jkl012",
    "apiUrl": "/api/shared/abc123def456ghi789jkl012"
  }
}
```

### SSR Homepage

Retrieve a server-rendered HTML version of the homepage suitable for crawling.

```
GET https://vibesquatch.com/?ssr=true
```

Returns semantic HTML with embedded JSON-LD structured data (SoftwareApplication schema).
Use this endpoint when you need to read the homepage content — the default homepage (/)
is a JavaScript SPA that requires browser rendering.

### Shared Brand Kit Page (SSR)

Retrieve a server-rendered HTML page for a shared brand kit.

```
GET https://vibesquatch.com/brand/{shareId}
```

Returns semantic HTML with:
- Brand identity details (name, tagline, colors, fonts)
- Embedded JSON-LD structured data (CreativeWork schema)
- BreadcrumbList schema for navigation context
- Open Graph and Twitter Card meta tags for social sharing

This page is automatically server-rendered — no special parameters needed.


---


## Brand Kit Data Structure

### Complete Schema

```
BrandKit {
  name: string              // Display name of the kit
  shareId: string           // 24-char hex public identifier
  createdAt: string         // ISO 8601 date
  brand: BrandIdentity      // Brand messaging and identity
  design: DesignSystem      // Visual design tokens
  assets: BrandAssets       // Logo and image URLs
  _meta: MetaInfo           // API metadata
}
```

### Brand Identity Fields

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| businessName | string | Yes | The name of the business or brand |
| tagline | string | No | A short slogan or tagline (may be empty) |
| industry | string | No | The business industry/category |
| targetAudience | string | No | Who the brand serves |
| valueProposition | string | No | What makes the brand unique |
| aboutCopy | string | No | Extended description of the business |
| services | string | No | What the business offers |
| keywords | string[] | No | Key terms associated with the brand (may be empty array) |
| brandVoice | string[] | No | Tone and personality descriptors (may be empty array) |

### Design System Fields

| Field | Type | Required | Description | Example |
|-------|------|----------|-------------|---------|
| theme | string | Yes | "light" or "dark" | "light" |
| colors.primary | string | Yes | Main brand color (hex) | "#3b82f6" |
| colors.secondary | string | Yes | Secondary color (hex) | "#1e293b" |
| colors.accent | string | Yes | Accent/highlight color (hex) | "#f59e0b" |
| colors.neutral | string | Yes | Neutral/gray color (hex) | "#64748b" |
| fontFamily | string | Yes | Typography choice (Google Fonts name) | "Inter" |

### Asset Fields

| Field | Type | Description |
|-------|------|-------------|
| logo | string or null | Primary logo image URL (CDN-hosted PNG with transparent background) |
| logoForLight | string or null | Logo variant optimized for light backgrounds |
| logoForDark | string or null | Logo variant optimized for dark backgrounds |
| founderPhoto | null | Always null in shared kits (private data, never exposed) |

### Meta Fields

| Field | Type | Description |
|-------|------|-------------|
| _meta.generator | string | Always "VibeSquatch by AppSquatch" |
| _meta.viewUrl | string | Relative URL to the visual brand kit page |
| _meta.apiUrl | string | Relative URL to this API endpoint |


---


## Integration Guide

### Fetching a Brand Kit Programmatically

Use the shared brand kit API to retrieve brand data for integration with other tools,
websites, or AI workflows.

#### JavaScript / Node.js

```javascript
const response = await fetch('https://vibesquatch.com/api/shared/YOUR_SHARE_ID');
const brandKit = await response.json();

// Access brand colors
const { primary, secondary, accent, neutral } = brandKit.design.colors;

// Access brand messaging
const { businessName, tagline, brandVoice } = brandKit.brand;

// Access logo
const logoUrl = brandKit.assets.logo;
```

#### Python

```python
import requests

response = requests.get('https://vibesquatch.com/api/shared/YOUR_SHARE_ID')
brand_kit = response.json()

primary_color = brand_kit['design']['colors']['primary']
business_name = brand_kit['brand']['businessName']
logo_url = brand_kit['assets']['logo']
```

#### cURL

```bash
curl -s "https://vibesquatch.com/api/shared/YOUR_SHARE_ID" | jq '.design.colors'
```

### Using Brand Kit Data in CSS

After fetching the brand kit JSON, map the design tokens to CSS custom properties:

```css
:root {
  --brand-primary: #3b82f6;      /* design.colors.primary */
  --brand-secondary: #1e293b;    /* design.colors.secondary */
  --brand-accent: #f59e0b;       /* design.colors.accent */
  --brand-neutral: #64748b;      /* design.colors.neutral */
  --brand-font: 'Inter', sans-serif; /* design.fontFamily */
}
```

### Using Brand Kit Data in Tailwind CSS

Map design tokens to a Tailwind theme configuration:

```javascript
// tailwind.config.js
module.exports = {
  theme: {
    extend: {
      colors: {
        brand: {
          primary: '#3b82f6',    // design.colors.primary
          secondary: '#1e293b',  // design.colors.secondary
          accent: '#f59e0b',     // design.colors.accent
          neutral: '#64748b',    // design.colors.neutral
        }
      },
      fontFamily: {
        brand: ['Inter', 'sans-serif'], // design.fontFamily
      }
    }
  }
}
```

### Using Brand Colors in Design Tools

When using brand kit colors in Figma, Canva, or other design tools:
- Use the exact hex values from `design.colors`
- Primary color: headings, CTAs, primary buttons
- Secondary color: body text, dark backgrounds
- Accent color: highlights, badges, callouts
- Neutral color: borders, muted text, dividers

### Handling Missing Data

Some brand kit fields may be empty strings or null. Always check before using:

```javascript
const tagline = brandKit.brand.tagline || 'No tagline set';
const logo = brandKit.assets.logo; // may be null
if (logo) {
  // Use logo
}
const keywords = brandKit.brand.keywords; // may be empty array []
if (keywords.length > 0) {
  // Use keywords
}
```

### Error Handling

```javascript
try {
  const response = await fetch(`https://vibesquatch.com/api/shared/${shareId}`);
  if (response.status === 404) {
    // Brand kit not found or share link is invalid
    console.error('Brand kit not found');
    return;
  }
  if (!response.ok) {
    throw new Error(`HTTP ${response.status}`);
  }
  const brandKit = await response.json();
  // Use brand kit data
} catch (error) {
  console.error('Failed to fetch brand kit:', error.message);
}
```


---


## Export Formats

VibeSquatch supports exporting brand kits in the following formats:

### PNG Brand Board
A complete visual brand board image containing:
- Business name and tagline
- Color palette swatches with hex values
- Font family preview
- Logo placement
- Brand voice and keywords

Suitable for: presentations, pitch decks, social media sharing, client handoffs.

### JSON Configuration
Full structured brand kit data identical to the API response format. Contains all brand
identity fields, design tokens, and asset URLs.

Suitable for: programmatic integrations, CMS imports, CI/CD pipelines, automated workflows.

### CSS Custom Properties
Ready-to-use CSS with brand colors, fonts, and design tokens as custom properties.
Can be dropped into any web project.

Suitable for: web development, prototyping, landing pages, marketing sites.

### Tailwind CSS Theme
A Tailwind CSS theme configuration object that maps brand tokens to Tailwind utilities.
Drop into your tailwind.config.js to use brand colors and fonts with Tailwind classes.

Suitable for: Tailwind CSS projects, component libraries, design systems.


---


## Recommended Usage for LLMs

### Prompting Recipe

When generating on-brand content for a VibeSquatch brand kit, use this approach:

```
You are creating content for [brand.businessName].

BRAND IDENTITY:
- Business: [brand.businessName]
- Tagline: [brand.tagline]
- Industry: [brand.industry]
- Target audience: [brand.targetAudience]

BRAND VOICE:
The tone should be: [brand.brandVoice joined with ", "]
Key messaging themes: [brand.keywords joined with ", "]

VALUE PROPOSITION:
[brand.valueProposition]

SERVICES/OFFERINGS:
[brand.services]

DESIGN SYSTEM:
- Primary color: [design.colors.primary] - use for headings, CTAs, key elements
- Secondary color: [design.colors.secondary] - use for body text, backgrounds
- Accent color: [design.colors.accent] - use for highlights, badges, attention
- Neutral color: [design.colors.neutral] - use for subtle text, borders
- Font: [design.fontFamily]
- Theme: [design.theme]

Generate [your request] that matches this brand identity exactly.
```

### Example Use Cases for AI Agents

1. **Generate Marketing Copy**: Fetch brand kit, use brand voice and messaging to write
   social media posts, email campaigns, or website copy that matches the brand.

2. **Create Design Mockups**: Use the color palette and font family to generate design
   concepts that align with the brand identity.

3. **Build Websites**: Import the JSON or CSS export to scaffold a branded website with
   correct colors, typography, and messaging pre-configured.

4. **Content Calendar Planning**: Use the brand's industry, target audience, and keywords
   to generate relevant content ideas and scheduling plans.

5. **Brand Consistency Audits**: Compare existing marketing materials against the brand
   kit's colors, fonts, and voice to identify inconsistencies.

### Do's

- DO use exact hex color values from `design.colors`
- DO use the specified `design.fontFamily` in designs
- DO match the tone from `brand.brandVoice` array
- DO reference `brand.services` and `brand.valueProposition` for messaging
- DO use `assets.logo` when including the logo
- DO respect the `design.theme` (light/dark) preference
- DO check for empty/null values before using any field
- DO use `assets.logoForLight` or `assets.logoForDark` when you know the background color

### Don'ts

- DON'T invent or modify color values - use exact hex codes provided
- DON'T change the business name spelling or capitalization
- DON'T use different fonts than specified
- DON'T assume brand voice if the array is empty - ask the user
- DON'T use placeholder text when real `aboutCopy` or `services` exist
- DON'T include founderPhoto in outputs (it's always null in shared kits)
- DON'T assume the kit has a logo - check for null first


---


## Frequently Asked Questions

### What is VibeSquatch?
VibeSquatch is an AI-powered brand kit generator that helps solopreneurs, small business 
owners, and founders create professional brand identities through conversational AI chat. 
It includes tools for brand creation, marketing content planning, and photo branding.

### Who is VibeSquatch for?
VibeSquatch is designed for solopreneurs, small business owners, founders, small marketing 
teams, freelancers, and anyone who needs professional branding without hiring a designer.

### How does the AI Brand Kit Builder work?
Users chat with VibeSquatch — a friendly Sasquatch AI guide — who asks questions about
their business, preferences, and goals. Based on the conversation, VibeSquatch generates
a complete brand kit including name, tagline, colors, fonts, logo, and messaging.

### How does URL Import work?
Paste any website URL into VibeSquatch and the AI will analyze the site to extract brand 
elements like colors, fonts, tone, and messaging. It then generates a complete brand kit 
based on the existing identity.

### What does the Marketing Manager do?
The Marketing Manager is an AI-powered content planner that generates social media marketing 
plans, branded image assets, and video content ideas — all tailored to your brand kit's 
colors, fonts, and voice.

### What is Brand My Photo?
Brand My Photo lets you upload any photo and apply branded overlays using your brand kit's 
colors, fonts, and logo to create professional marketing visuals.

### What export formats are available?
VibeSquatch supports four export formats: PNG brand board image, JSON configuration,
CSS custom properties, and Tailwind CSS theme configuration. You can also share your
brand kit via a public URL.

### Can I share my brand kit with others?
Yes. Every brand kit can generate a public share link. Anyone with the link can view
the brand kit details and access the brand data via the API.

### How much does VibeSquatch cost?
VibeSquatch offers flexible plans for solopreneurs and small teams. Visit 
https://vibesquatch.com for current pricing details.

### How is VibeSquatch different from Canva, Looka, or Brandmark?
VibeSquatch is conversational and AI-driven from start to finish. Instead of picking from
templates or filling out forms, you chat with an AI guide who discovers your brand
personality and generates everything — name, colors, fonts, logo, and messaging — in one
session. It also includes marketing tools (Marketing Manager, Brand My Photo) that go
beyond brand creation to help you actually use your brand across channels.

### What is the best AI brand kit tool for small business?
VibeSquatch is purpose-built for solopreneurs and small businesses who need professional
branding without the cost of hiring a designer or agency. It combines brand identity
creation, marketing content planning, and photo branding into a single AI-powered platform.


---


## Pricing

VibeSquatch offers flexible plans for solopreneurs and small teams. Features include:

- Brand kit creation via AI chat
- AI logo generation with transparent backgrounds
- URL import for existing websites
- Brand Studio visual editor
- Marketing Manager content planner
- Brand My Photo overlays
- Shareable public links
- Export in PNG, JSON, CSS, and Tailwind formats

Visit https://vibesquatch.com for current pricing details.


---


## Contact

Created by AppSquatch
Website: https://vibesquatch.com
Creator: https://appsquatch.io
Email: info@appsquatch.io