CLAUDE.md
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.Project Overview
This is the FormHug Help Center — a documentation site for FormHug (formhug.ai), a smart form builder product. Built with Mintlify.Development Commands
main branch triggers automatic deployment via Mintlify.
Architecture
- docs.json — Main Mintlify configuration: navigation structure, theme, colors, footer, integrations, SEO settings. All page routing is defined here under
navigation.tabs[].groups[].pages. - All content pages are
.mdxfiles using Mintlify’s MDX components (not plain Markdown). - No package.json, no build step, no tests, no linting — this is a pure Mintlify docs site.
Content Structure
The site uses a tab-based navigation with four top-level tabs:| Tab | Path | Content |
|---|---|---|
| Introduction | introduction/ | Welcome, getting started, plans & billing |
| Features | features/ | Builder, scenes, settings, styling, sharing, data, account |
| Guides | guides/ | Use cases, embedding tutorials, tips |
| Resources | resources/ | FAQ, support, team, changelog, legal |
Key Conventions
- Adding/removing pages: Update both the
.mdxfile AND thedocs.jsonnavigation array — pages not listed indocs.jsonwon’t appear in navigation. - Field Types are nested as a sub-group under
features/building/fields/withexpanded: false. - Scenes (Booking, Quiz, Assessment, Public Query) are under
features/scenes/. - Icon library: FontAwesome (configured in
docs.json). - Analytics: PostHog integration is configured.