sanity-best-practices

The `sanity-best-practices` skill provides comprehensive guidelines and reference material for developers working with the Sanity content platform. It addresses common challenges in content modeling, schema design, GROQ query optimization, Visual Editing, image handling, Portable Text, Studio structure, TypeGen configuration, localization, and migrations. The skill also covers automation through Sanity Functions, infrastructure management with Blueprints, and integration with various frontend frameworks such as Next.js, Nuxt, Astro, Remix, SvelteKit, Angular, Hydrogen, and the Sanity App SDK. Its primary goal is to streamline Sanity development workflows, ensure code quality, and reduce errors when building or maintaining Sanity-based projects.

Key features include detailed integration guides for frontend frameworks, topic-specific reference files for core Sanity functionality, and best practices for schema design, content modeling, and type safety. It offers quick references for GROQ queries, Visual Editing, page builder configurations, image management, Studio organization, TypeGen workflows, SEO, localization, and content migrations. Additionally, the skill provides guidance on event-driven content automation, Blueprints for infrastructure as code, and custom applications leveraging Sanity Functions and the App SDK. Each reference includes correct and incorrect code examples, decision matrices, workflow guidance, and framework-specific patterns where applicable.

This skill is suitable for developers, technical leads, and content engineers who work with Sanity or integrate it into frontend applications. It is particularly useful for teams setting up new projects, onboarding developers, optimizing queries and content workflows, implementing live previews, managing Studio structure, or maintaining and refactoring existing codebases. By following these best practices, users can ensure consistent, maintainable, and efficient Sanity implementations while leveraging the platform's full capabilities.