Sanity Plugins Monorepo

This monorepo is the home for Sanity Studio plugins maintained by Sanity staff and the community. It provides a centralized place for developing, testing, and publishing plugins that extend Sanity Studio's functionality.

Repository Structure

.
├── plugins/           # Sanity Studio plugins
├── packages/          # Shared packages and utilities
│   └── @repo/          # Internal monorepo utilities (not published)
└── dev/
    └── test-studio    # Local Sanity Studio for testing plugins

Plugins (./plugins)

This is where all Sanity Studio plugins live.

Packages (./packages)

The packages folder contains two types of packages:

1. Published utilities - Helpful libraries used by plugins that are published to npm
2. Internal packages (@repo/*) - Shared configurations for tooling (TypeScript, ESLint, etc.) that are not published to npm and are only used within this monorepo

Getting Started

Prerequisites

• Node.js (latest LTS)
• pnpm v10 or later (managed via corepack)

Installation

# Enable corepack for automatic pnpm version management
corepack enable

# Install dependencies
pnpm install

Development

# Start the test studio for local development
pnpm dev

# Run linting and type checking
pnpm lint

# Build all packages
pnpm build

# Format code (this also runs through a pre-commit git hook)
pnpm format

Inspecting Builds with Vite DevTools

The test studio can run with Vite DevTools enabled to inspect what sanity build produces: module graph, chunk composition, plugin timings, and bundle treemaps.

# Build the test studio with devtools enabled, then start the dev server
pnpm devtools:test-studio

Open http://localhost:3333 and use the DevTools dock (or the full-page UI at http://localhost:3333/__devtools/) to explore the recorded build session. The first time a browser connects, approve the one-time permission prompt shown in the terminal.

To record a fresh build session after making changes—while the dev server is still running—run in a second terminal:

pnpm devtools:test-studio:build

Sessions can be compared in the DevTools UI to diff bundle changes between builds. DevTools is opt-in (via the ENABLE_VITE_DEVTOOLS=true env flag these scripts set) because it makes builds slower and writes large session logs to dev/test-studio/node_modules/.rolldown. See AGENTS.md for more details.

Current Plugins

Tooling Packages

Contributing

We welcome contributions! Please see CONTRIBUTING.md for detailed guidelines on:

• Development Setup
• Running the Test Studio
• Code Quality
• Adding a New Plugin
• Migrating an Existing Plugin
• Publishing Packages

License

MIT © Sanity.io