Jamdesk Documentation logo

Project Setup Overview

Create a project, connect GitHub, organize your repo, and decide who can read your docs. Start here if your site isn't live yet.

Every Jamdesk site starts the same way: a project in the dashboard, a GitHub repo behind it, and a docs.json file that describes your navigation. This section covers that initial setup, plus the structural decisions worth making early. URL layout, languages, and access control are all much easier to settle before you have fifty pages than after.

Migrating from another platform? Skip ahead to the Migration Guide. Jamdesk can automate most of the conversion.

From Repo to Live Site

1
Create a project

Start from a template or connect an existing GitHub repo. Your site goes live at yourproject.jamdesk.app.

2
Connect GitHub

Install the GitHub App so every push deploys automatically.

3
Organize the repo

A docs.json file plus MDX pages. That's the whole contract.

Core Setup

Create a Project

From a template or an existing repo to a live site

Connect GitHub

App installation, repository access, and automatic deploys on push

Directory Structure

Required files, page directories, images, and snippets

Migration Guide

Move from another documentation platform, automated or manual

Monorepo Support

Keep docs alongside your code when they aren't at the repo root

Multi-Language Support

Serve docs in multiple languages with a language switcher

Site Structure

Navigation

Tabs, groups, and pages that organize your documentation

Redirects

Exact and pattern-based redirects for moved or renamed pages

Privacy & Access

Access Control

Fully public, password-gated, mixed, or SSO. Compare the options.

Password Protection

Lock the whole site or just a handful of pages behind a shared password

Single Sign-On (SSO)

SAML or OIDC through your identity provider