GravityKit Developer Documentation

Unified Docusaurus site for all GravityKit product hooks documentation at gravitykit.dev.

Overview

This documentation site consolidates hooks, filters, and developer documentation from all GravityKit products into a single, searchable, and well-organized platform. Documentation is generated directly from GitHub repositories, making it fully portable and reproducible.

Products Included

GravityView - Display Gravity Forms entries in customizable layouts
GravityCalendar - Transform entries into interactive calendars
GravityCharts - Visualize form data with charts and graphs
GravityImport - Import data into Gravity Forms
GravityMath - Mathematical calculations for forms
GravityExport - Export form data in multiple formats
GravityEdit - Edit entries from the frontend
GravityBoard - Kanban board for entries
And 20+ more GravityKit products!

Quick Start

# Install dependencies
npm install

# Clone product repositories from GitHub
npm run repos:clone

# Generate hooks documentation
npm run hooks:generate

# Start local development server
npm start

Or run everything at once:

npm run docs:full

Prerequisites

Required

Node.js 18+ - JavaScript runtime
Git - For cloning repositories
wp-hooks-documentor - Tool for extracting WordPress hooks

# Install wp-hooks-documentor globally (GravityKit fork)
npm install -g github:GravityKit/wp-hooks-documentor

GitHub Authentication

The clone script needs access to GravityKit repositories. Choose one method:

Option A: GitHub CLI (Recommended)

# Install GitHub CLI
brew install gh  # macOS
# or see https://cli.github.com/

# Authenticate
gh auth login

Option B: SSH Keys

Configure SSH keys with access to GravityKit organization
See: https://docs.github.com/en/authentication/connecting-to-github-with-ssh

Available Commands

Command	Description
`npm run repos:clone`	Clone/update all product repositories from GitHub
`npm run hooks:generate`	Generate hooks documentation from cloned repos
`npm run docs:full`	Full pipeline: clone repos, generate docs, build site
`npm start`	Start local development server
`npm run build`	Build static site for production
`npm run serve`	Serve the built site locally

Command Options

Clone/Update Repositories

npm run repos:clone                     # Clone/update all repos
npm run repos:clone -- --force          # Force fresh clone (delete existing)
npm run repos:clone -- --product gravityview  # Clone specific product
npm run repos:clone -- --parallel 8     # Use 8 parallel operations
npm run repos:clone -- --help           # Show help

Generate Documentation

npm run hooks:generate                     # Generate all hooks docs
npm run hooks:generate -- --product gravityview  # Generate specific product
npm run hooks:generate -- --dry-run        # Preview without making changes
npm run hooks:generate -- --help           # Show help

Project Structure

gravitykit.dev/
├── docs/                       # Documentation output
│   ├── index.md               # Main homepage
│   ├── gravityview/           # Each product gets its own directory
│   ├── gravitycalendar/
│   ├── gravitycharts/
│   └── ...                    # 27 total products
├── repos/                     # Cloned GitHub repos (gitignored)
│   ├── GravityView/
│   ├── GravityCalendar/
│   └── ...
├── scripts/
│   ├── clone-repos.mjs        # Clone/update GitHub repos
│   └── regen-hooks-docs-new.mjs  # Generate hooks documentation
├── src/
│   ├── pages/                 # Custom pages
│   └── css/                   # Styling
├── static/                    # Static assets
├── repos-config.json          # GitHub repos configuration
├── docusaurus.config.js       # Site configuration
├── sidebars.js               # Navigation structure
└── package.json

Configuration

repos-config.json

Central configuration file mapping products to GitHub repositories:

{
  "reposDir": "./repos",
  "outputDir": "./docs",
  "defaults": {
    "branch": "develop",
    "ignoreFiles": ["**/vendor/**", "**/node_modules/**"],
    "ignoreHooks": ["deprecated_*", "private_*"]
  },
  "products": [
    {
      "id": "gravityview",
      "repo": "GravityKit/GravityView",
      "label": "GravityView",
      "routeBasePath": "docs/gravityview"
    }
  ]
}

Adding a New Product

Add an entry to repos-config.json:

{
  "id": "new-product",
  "repo": "GravityKit/NewProduct",
  "label": "New Product Name",
  "routeBasePath": "docs/new-product"
}

Regenerate documentation:

npm run repos:clone -- --product new-product
npm run hooks:generate -- --product new-product

Deployment

GitHub Pages (Automated)

This repo includes a GitHub Actions workflow (.github/workflows/deploy.yml) that automatically builds and deploys to GitHub Pages on every push to main.

Setup:

Create a GitHub Personal Access Token with repo scope (to access private GravityKit repos)
Add it as a repository secret named GK_REPOS_TOKEN:
- Go to repo Settings → Secrets and variables → Actions
- Click "New repository secret"
- Name: GK_REPOS_TOKEN
- Value: Your personal access token
Enable GitHub Pages:
- Go to repo Settings → Pages
- Source: "GitHub Actions"
Push to main branch - the workflow will automatically build and deploy

Custom Domain: The site is configured for gravitykit.dev. To use a different domain:

Update static/CNAME with your domain
Update url in docusaurus.config.js
Configure DNS to point to GitHub Pages

Vercel

Connect your GitHub repository to Vercel
Configure build command: npm run docs:full
Output directory: build
Add environment variable: GH_TOKEN with your GitHub token

Netlify

Connect your GitHub repository to Netlify
Configure build command: npm run docs:full
Publish directory: build
Add environment variable: GH_TOKEN with your GitHub token

Manual Deployment

npm run docs:full  # Clone repos, generate docs, build
# Then deploy the 'build' directory to your host

LLM-Friendly Documentation

This documentation is optimized for consumption by Large Language Models (LLMs) to help developers using AI assistants:

Features

/llms.txt - Root context file with overview and product directory
/docs/{product}/llms.txt - Per-product AI documentation (25+ files)
/docs/{product}/**/*.md - Raw Markdown for any individual doc (append .md to a doc URL)
/api/hooks/index.json - Product directory with stats (6KB)
/api/hooks/{product}.json - Per-product hooks (25 files, 1KB-408KB each)
Raw Markdown endpoints - Published automatically during the build, so any doc page can be fetched as a .md file.
Usage examples - Every hook includes copy-paste-ready code examples
Structured data - Consistent frontmatter and parameter tables

Dual Format Strategy

Each product provides documentation in two complementary formats:

JSON API (/api/hooks/{product}.json):

Machine-readable structure for programmatic access
Complete hook metadata (parameters, types, locations)
Ideal for building tools and integrations

Markdown Documentation (/docs/{product}/llms.txt):

AI-optimized natural language format
Product overview and capabilities
Top 10-15 most commonly used hooks with full code examples
Hooks grouped by use case (display, data, fields, search, etc.)
Common integration patterns and best practices
Pro tips for AI assistants

Machine-Readable API

The hooks API provides programmatic access to all hook information:

# Discover available products (lightweight - 6KB)
curl https://www.gravitykit.dev/api/hooks/index.json

# Get hooks for a specific product (JSON format - recommended for tools)
curl https://www.gravitykit.dev/api/hooks/gravityview.json
curl https://www.gravitykit.dev/api/hooks/gravityedit.json

# Get AI-optimized documentation (Markdown format - recommended for LLMs)
curl https://www.gravitykit.dev/docs/gravityview/llms.txt
curl https://www.gravitykit.dev/docs/gravityedit/llms.txt

# Get raw Markdown for any individual doc (append .md to the doc URL)
curl https://www.gravitykit.dev/docs/gravitycalendar/actions/gravityview-calendar-enqueue-scripts.md

# Full database (large - 728KB, use per-product instead)
curl https://www.gravitykit.dev/api/hooks.json

Regenerating LLM Enhancements

npm run llm:enhance  # Regenerate JSON APIs, llms.txt files, and add examples

IDE Integration

Add GravityKit hooks documentation to your AI-powered code assistant.

Cursor

Open Cursor Settings (Cmd/Ctrl + ,)
Go to Features → Docs
Click Add new doc
Enter: https://www.gravitykit.dev

Cursor will index the documentation and use it when answering questions about GravityKit plugins.

Windsurf

Open Windsurf Settings
Go to Cascade → Memories & rules
Under Indexed Docs, click Add
Enter: https://www.gravitykit.dev

Other IDEs

For IDEs without built-in doc indexing, add to your project instructions file:

VS Code (.github/copilot-instructions.md):

Reference GravityKit hooks at https://www.gravitykit.dev
API: https://www.gravitykit.dev/api/hooks/{product}.json

Claude Code (CLAUDE.md):

Fetch GravityKit hooks from https://www.gravitykit.dev/api/hooks/{product}.json

Available Endpoints

Endpoint	Format	Description
`/llms.txt`	Markdown	Root context file with overview and product directory
`/docs/{product}/llms.txt`	Markdown	Per-product AI-optimized documentation with examples and use cases
`/docs/{product}/*/.md`	Markdown	Raw Markdown for any individual doc (append `.md` to a doc URL)
`/api/hooks/index.json`	JSON	Product directory with hook counts (lightweight - 6KB)
`/api/hooks/{product}.json`	JSON	Complete hooks data for a specific product (1KB-408KB)

Recommendation: For AI assistants, start with /docs/{product}/llms.txt for focused context. For tools and integrations, use /api/hooks/{product}.json for structured data.

Products: gravityview, gravitycalendar, gravitycharts, gravityedit, gravityexport, gravityimport, gravitymath, gravityactions, gravityboard, gravitymigrate, gravityrevisions, and more.

Sitemaps

The site automatically generates XML sitemaps for search engine optimization:

/sitemap.xml - Main site-wide sitemap (all pages)
/sitemap-products.xml - Product-specific sitemap index
/docs/{product}/sitemap.xml - Individual product sitemaps (28 products)

Features

Automatic Generation: Sitemaps are built during npm run build
Smart Priorities: Product home pages (0.9), top-level docs (0.7), hooks (0.6)
HTML Discovery: Both sitemaps are linked in the <head> of every page
robots.txt: Both sitemaps are listed for search engine crawlers

Example URLs

https://www.gravitykit.dev/sitemap.xml
https://www.gravitykit.dev/sitemap-products.xml
https://www.gravitykit.dev/docs/gravityview/sitemap.xml
https://www.gravitykit.dev/docs/gravitycalendar/sitemap.xml

For more details, see SITEMAPS.md.

Environment Variables

The site uses environment variables for optional integrations. Set these in your deployment environment or local .env file.

Google Analytics

Track site usage with Google Analytics 4:

Variable	Description	Example
`GOOGLE_GTAG_ID`	Google Analytics 4 measurement ID	`G-XXXXXXXXXX`

The site uses @docusaurus/plugin-google-gtag with IP anonymization enabled for privacy compliance.

Algolia Search

The site uses Algolia DocSearch for search functionality:

Variable	Description
`ALGOLIA_APP_ID`	Algolia application ID
`ALGOLIA_API_KEY`	Algolia search-only API key
`ALGOLIA_INDEX_NAME`	Index name (defaults to `gravitykit`)

To set up search:

Apply for Algolia DocSearch
Set the environment variables above in your deployment settings
Configure the Algolia crawler to automatically index the site on a schedule (currently set to daily)

GitHub Access

For cloning private GravityKit repositories:

Variable	Description
`GK_REPOS_TOKEN`	GitHub Personal Access Token with `repo` scope
`GH_TOKEN`	Alternative name (used by some deployment platforms)

Example .env file

# Google Analytics
GOOGLE_GTAG_ID=G-XXXXXXXXXX

# Algolia Search (for search UI)
ALGOLIA_APP_ID=your-app-id
ALGOLIA_API_KEY=your-search-api-key
ALGOLIA_INDEX_NAME=gravitykit

# GitHub Access (for CI/CD)
GK_REPOS_TOKEN=ghp_xxxxxxxxxxxx

Troubleshooting

Clone fails with authentication error

# Check GitHub CLI authentication
gh auth status

# Or verify SSH key
ssh -T git@github.com

wp-hooks-documentor not found

# Install globally (GravityKit fork)
npm install -g github:GravityKit/wp-hooks-documentor

# Verify installation
wp-hooks-documentor --version

Build fails due to missing docs

The build will skip products that don't have generated documentation. Run:

npm run repos:clone
npm run hooks:generate

Support

Main Documentation: https://docs.gravitykit.com
Support Portal: https://www.gravitykit.com/support/
GitHub: https://github.com/gravitykit

Name		Name	Last commit message	Last commit date
Latest commit History 65 Commits
.github/workflows		.github/workflows
scripts		scripts
src		src
static		static
templates/hooks		templates/hooks
.env.example		.env.example
.gitignore		.gitignore
DEPLOYMENT.md		DEPLOYMENT.md
README.md		README.md
docusaurus.config.js		docusaurus.config.js
netlify.toml		netlify.toml
package-lock.json		package-lock.json
package.json		package.json
repos-config.json		repos-config.json
sidebars.js		sidebars.js
type-links.json		type-links.json
vercel.json		vercel.json

GravityKit/gravitykit.dev

Folders and files

Latest commit

History

Repository files navigation

GravityKit Developer Documentation

Overview

Products Included

Quick Start

Prerequisites

Required

GitHub Authentication

Available Commands

Command Options

Project Structure

Configuration

repos-config.json

Adding a New Product

Deployment

GitHub Pages (Automated)

Vercel

Netlify

Manual Deployment

LLM-Friendly Documentation

Features

Dual Format Strategy

Machine-Readable API

Regenerating LLM Enhancements

IDE Integration

Cursor

Windsurf

Other IDEs

Available Endpoints

Sitemaps

Features

Example URLs

Environment Variables

Google Analytics

Algolia Search

GitHub Access

Example .env file

Troubleshooting

Clone fails with authentication error

wp-hooks-documentor not found

Build fails due to missing docs

Support

License

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Contributors 2

Uh oh!

Languages

Packages