Astro Plugin for Cursor

A Cursor plugin that enhances your Astro development experience with documentation access, coding standards, and guided workflows.

Features

Astro Docs MCP

Direct access to the official Astro documentation via the Astro Docs MCP server. Search and retrieve documentation without leaving your editor.

Rules

• astro-best-practices.mdc - Comprehensive Astro coding standards covering:
  • Project structure conventions
  • Component patterns and client directives
  • Content collections usage
  • Performance optimization
  • Accessibility requirements
  • Styling approaches

Skills

Skill	Description
docs-lookup	Search Astro documentation using the MCP for APIs, configuration, and best practices
create-component	Scaffold components, pages, and layouts with templates and accessibility checklist
content-collection	Set up content collections with type-safe Zod schemas for blogs, docs, or portfolios
add-integration	Complete integration setup guide including post-install configuration
migrate	Guide migration from Next.js, Nuxt, Gatsby, or upgrade between Astro versions

Installation

1. Open Cursor Settings
2. Navigate to Plugins
3. Search for "Astro"
4. Click Install

Or install via the command palette:

1. Open Command Palette (Cmd/Ctrl + Shift + P)
2. Type "Install Plugin"
3. Search for "Astro"

Usage

Documentation Lookup

Ask questions about Astro and the plugin will search the official docs:

• "How do I set up content collections?"
• "What client directives are available?"
• "How do I deploy to Netlify?"

Component Creation

Ask the assistant to create components:

• "Create a Card component with title and image props"
• "Scaffold a blog post page with dynamic routing"
• "Set up a base layout with SEO meta tags"

Content Collections

Get help setting up structured content:

• "Set up a blog with content collections"
• "Create a schema for my portfolio projects"
• "How do I reference authors from my blog posts?"

Integrations

Get guided through complete integration setup:

• "Add Tailwind CSS to my project"
• "Set up React with the right client directives"
• "Configure Netlify adapter for SSR"

Migration

Get help migrating to Astro:

• "Migrate my Next.js app to Astro"
• "Convert this Gatsby GraphQL query to content collections"
• "Upgrade from Astro v4 to v5"

Resources

• Astro Documentation
• Astro Discord
• Astro GitHub

License

MIT