Jamdesk Starter Template

The official starter template for Jamdesk documentation sites. Clone this repository to create beautiful, professional documentation in minutes.

Documentation · Get Started · Dashboard

What is Jamdesk?

Jamdesk is a modern documentation platform that transforms MDX (Markdown + React components) into polished, production-ready documentation websites.

Why teams choose Jamdesk:

• Write in MDX - Markdown with React components for interactive docs
• Deploy instantly - Push to GitHub, deploy globally in seconds
• Professional themes - Three built-in themes (Jam, Nebula, Pulsar)
• AI-ready - Auto-generates llms.txt for ChatGPT, Claude, Copilot
• Built-in search - AI-powered search out of the box
• Analytics included - Track page views and search queries

What's Included

This starter template includes everything you need to get started:

starter-docs/
├── docs.json              # Site configuration (theme, colors, navigation)
├── introduction.mdx       # Welcome page (sample product docs)
├── quickstart.mdx         # Getting started guide
├── configuration.mdx      # Branding, navigation, and site settings
├── api-reference.mdx      # API docs overview (OpenAPI + hand-authored)
├── api-reference/         # Auto-generated from OpenAPI spec
│   ├── create-payment.mdx
│   └── list-payments.mdx
├── openapi/               # OpenAPI spec files
│   └── acme.yaml
├── images/                # Place images and screenshots here
├── components/            # Component examples
│   ├── callouts.mdx       # Notes, warnings, tips
│   ├── cards.mdx          # Card layouts
│   ├── steps.mdx          # Step-by-step guides
│   └── tabs-and-accordions.mdx
└── writing/               # Content writing guides
    ├── code-blocks.mdx    # Syntax highlighting
    ├── components.mdx     # Using MDX components
    ├── images.mdx         # Images and media
    └── pages.mdx          # Page structure

Theme: This template uses the Jam theme - a clean, modern design with purple accent colors. See all themes →

Quick Start

Option 1: Use the Dashboard (Recommended)

1. Sign up at dashboard.jamdesk.com
2. Create a new project and select "Starter Template"
3. Connect your GitHub repository
4. Start editing - changes deploy automatically

Option 2: Use This Template

Click the green "Use this template" button at the top of this page to create your own repository based on this starter.

Option 3: Clone and Deploy

# Clone this template
git clone https://github.com/jamdesk/starter-docs.git my-docs
cd my-docs

# Preview locally (requires Jamdesk CLI)
npm install -g jamdesk          # via npm
brew install jamdesk/tap/jamdesk # via Homebrew (alternative)
jamdesk dev

# Open http://localhost:3000

Then connect your repository to Jamdesk via the dashboard.

Customization

Change Theme Colors

Edit docs.json to customize your brand colors:

{
  "colors": {
    "primary": "#6366F1",
    "light": "#818CF8",
    "dark": "#4F46E5"
  }
}

Switch Themes

Change the theme in docs.json:

{
  "theme": "jam"
}

Add Your Logo

{
  "logo": {
    "light": "/images/logo-light.svg",
    "dark": "/images/logo-dark.svg"
  }
}

Writing Content

All content is written in MDX - Markdown with React components:

---
title: Authentication
description: API keys, OAuth tokens, and webhook signatures
---

## API Keys

Every request requires a Bearer token in the `Authorization` header.

<Note>
  Use test keys (`sk_test_...`) during development. No real charges are created.
</Note>

<Steps>
  <Step title="Get your key">Go to **Settings → API Keys** in the dashboard.</Step>
  <Step title="Add to your request">Pass it as a Bearer token in the Authorization header.</Step>
</Steps>

Available components: Cards, Tabs, Accordions, Steps, Callouts, Code Groups, and 20+ more →

Local Development

Preview your docs locally with hot reload:

# Install the CLI (choose one)
npm install -g jamdesk          # via npm
brew install jamdesk/tap/jamdesk # via Homebrew

# Start the dev server
jamdesk dev

# Validate your docs
jamdesk validate

# Check for broken links
jamdesk broken-links

Documentation

• Jamdesk Documentation - Full platform docs
• Quickstart Guide - Get started in 5 minutes
• MDX Basics - Writing content
• Components - All available components
• Theming - Customize your site
• docs.json Reference - Full configuration options

Deploy

Jamdesk handles deployment automatically:

1. Push changes to your connected GitHub repository
2. Jamdesk builds your site (typically under 30 seconds)
3. Your docs are live on your custom domain or yoursite.jamdesk.app

No build configuration required. No CI/CD setup needed.

Support

• Documentation: jamdesk.com/docs
• Help Center: jamdesk.com/docs/help
• Issues: github.com/jamdesk/starter-docs/issues

License

MIT - Use this template for any project, commercial or personal.

---

Built with Jamdesk - Beautiful documentation that developers actually love.