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

# Lab Site

> Every lab gets a public research website at {slug}.hubify.app, automatically synced with your experiments, papers, and results.

# Lab Site

Every lab in Hubify Labs gets a **public research website** deployed at `{slug}.hubify.app`. This site is automatically generated and synced with your lab's experiments, papers, figures, and knowledge base.

## What Gets Published

| Content           | Source                             | Auto-Synced |
| ----------------- | ---------------------------------- | ----------- |
| Research overview | Lab description + key results      | Yes         |
| Papers            | Paper pipeline manuscripts         | Yes         |
| Figures           | Experiment-generated plots         | Yes         |
| Activity timeline | Experiment completions, milestones | Yes         |
| Data explorer     | Embedded interactive datasets      | Yes         |
| Glossary          | Knowledge base terms and equations | Yes         |
| Articles          | Long-form research explainers      | Manual      |

## Site Structure

A typical lab site includes these pages:

* **Homepage**, Research overview, key results, stat cards
* **Papers**, Paper listings with readiness percentages and version history
* **Explainer**, Non-technical explanation of the research
* **Data Explorer**, Interactive MCMC and dataset exploration
* **Figures**, Gallery with lightbox viewer
* **Glossary**, Searchable terms with pronunciations and equations
* **Activity**, Chronological research timeline
* **Timeline**, Visual representation of the research arc

## Automatic Sync

<Note>
  The lab site must always reflect the current state of the research. Hubify enforces this with the Website Sync Protocol.
</Note>

When research state changes, the corresponding site pages update:

* **New experiment completes** → Activity page, stat cards, data explorer
* **Paper revision** → Papers page, version history
* **New figures** → Figure gallery
* **Knowledge base update** → Glossary, data explorer
* **Branch opens/closes** → Activity timeline, stat cards

## Customization

Customize your lab site's appearance:

```bash theme={null}
# Set custom domain
hubify site domain --set research.example.com

# Update site theme
hubify site theme --primary "#5fb88a" --font "Newsreader"

# Add a custom page
hubify site page add --slug "methods" --title "Our Methods"

# Deploy changes
hubify site deploy
```

## Styling

Lab sites use a clean, academic aesthetic:

* **Typography**, Serif headings (Newsreader), sans-serif body (Inter), monospace code (JetBrains Mono)
* **Layout**, Light mode, responsive, mobile-friendly
* **Navigation**, Consistent nav bar across all pages with mobile hamburger menu

## Custom Domain

You can point a custom domain to your lab site:

1. Add a CNAME record pointing to `cname.hubify.app`
2. Run `hubify site domain --set yourdomain.com`
3. SSL is provisioned automatically

## Deployment

Lab sites deploy automatically when you push changes. The site is hosted on Vercel with zero configuration required.

```bash theme={null}
# Manual deploy
hubify site deploy

# Preview before deploying
hubify site preview

# Check deployment status
hubify site status
```

## Embedding

Embed lab site components on external pages:

```html theme={null}
<!-- Embed the data explorer -->
<iframe src="https://your-lab-slug.hubify.app/data-explorer?embed=true"
        width="100%" height="600"></iframe>

<!-- Embed the activity timeline -->
<iframe src="https://your-lab-slug.hubify.app/activity?embed=true"
        width="100%" height="400"></iframe>
```