docs: add Cursor IDE development rules with MCP integration for enhanced developer experience #1819

benpsnyder · 2025-08-02T19:56:19Z

🎯 Overview

This PR introduces comprehensive Cursor IDE integration and development rules to enhance the developer experience across the entire Analog workspace. The changes establish consistent coding practices, AI-assisted development capabilities, and streamlined workflows for all contributors.

✨ Key Changes

🔧 Infrastructure Enhancements

Nx MCP Server Integration: Added .cursor/mcp.json for AI-assisted development with Nx tools
TUI Configuration: Enabled terminal UI features in nx.json for better developer experience
Global Development Rules: Established workspace-wide coding standards and best practices

📚 Package-Specific Documentation

37 new rule files added across all packages and apps
Individual development guidelines for each of the 12 Analog packages
CI/CD best practices tailored to each package's specific needs
Architecture guidance for maintainable and scalable code

🏗️ Development Workflow Improvements

Consistent Nx usage patterns with tool-specific guidelines
Automated workflow guidance for common development tasks
Package-specific onboarding for new contributors
AI-assisted development with context-aware coding assistance

💢 Impact

+2,881 lines of development documentation and guidelines
37 files added for comprehensive development support
12 packages now have individual development rule sets
5 apps equipped with specific CI/CD guidelines

🚀 Benefits for Maintainers

Consistent Code Quality: Standardized development practices across all packages
Faster Onboarding: Clear guidelines for new contributors
Reduced Review Time: Established patterns and best practices
Better Tooling: AI-assisted development with Nx integration
Automated Workflows: Streamlined CI/CD processes

📁 Files Changed

Global Configuration

.cursor/mcp.json - Nx MCP server configuration
.cursor/rules/nx-rules.mdc - Nx workspace guidelines
.cursor/rules/repo-ci-cd.mdc - Global CI/CD practices
.cursor/settings.json - Cursor IDE settings
nx.json - TUI configuration added

Package-Specific Rules

Each package now includes:

.cursor/rules/ci-cd.mdc - CI/CD guidelines
.cursor/rules/development.mdc - Development best practices

Apps: analog-app, blog-app, docs-app, ng-app, trpc-app
Packages: astro-angular, content, content-plugin, create-analog, nx-plugin, platform, router, storybook-angular, trpc, vite-plugin-angular, vite-plugin-nitro, vitest-angular

🧪 Testing

All existing functionality remains unchanged
No runtime dependencies added
Configuration changes are additive and non-breaking
Development rules provide guidance without enforcing breaking changes

📝 Migration Notes

No migration required for existing code
New development rules are opt-in and provide guidance
CI/CD workflows remain compatible with existing processes
Nx MCP server integration is optional and can be disabled

netlify · 2025-08-02T19:56:23Z

✅ Deploy Preview for analog-blog ready!

Name	Link
🔨 Latest commit	`6a53072`
🔍 Latest deploy log	https://app.netlify.com/projects/analog-blog/deploys/68a0a5600adc5d0008d85a1f
😎 Deploy Preview	https://deploy-preview-1819--analog-blog.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

netlify · 2025-08-02T19:56:23Z

✅ Deploy Preview for analog-docs ready!

Name	Link
🔨 Latest commit	`6a53072`
🔍 Latest deploy log	https://app.netlify.com/projects/analog-docs/deploys/68a0a56053723b00083fddb9
😎 Deploy Preview	https://deploy-preview-1819--analog-docs.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

netlify · 2025-08-02T19:56:24Z

✅ Deploy Preview for analog-app ready!

Name	Link
🔨 Latest commit	`6a53072`
🔍 Latest deploy log	https://app.netlify.com/projects/analog-app/deploys/68a0a56053723b00083fddbb
😎 Deploy Preview	https://deploy-preview-1819--analog-app.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

benpsnyder · 2025-08-02T19:58:12Z

@brandonroberts plan is to keep stacking rules per package so we can do some refactoring (no changes to functionality) to enhance test coverage, debuggability, and make it easy for new contributors to understand the pipeline of the tooling ... vite/nitro/h3 etc ...
Once stable in the beta branch we can then use this to make more aggressive changes in alpha

netlify · 2025-08-02T19:59:09Z

✅ Deploy Preview for analog-ng-app ready!

Name	Link
🔨 Latest commit	`6a53072`
🔍 Latest deploy log	https://app.netlify.com/projects/analog-ng-app/deploys/68a0a5601349850008a9f17d
😎 Deploy Preview	https://deploy-preview-1819--analog-ng-app.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

.cursor/mcp.json

.cursor/settings.json

…berts

…berts

benpsnyder · 2025-08-02T23:33:52Z

@brandonroberts apps/**/.cursor has been removed

brandonroberts · 2025-08-03T22:04:03Z

packages/content-plugin/.cursor/rules/ci-cd.mdc

+- Lint: `nx lint content-plugin`
+
+## Build Details
+- Uses esbuild executor


This is incorrect.

Suggested change

- Uses esbuild executor

- Uses esbuild executor

brandonroberts · 2025-08-03T22:06:07Z

packages/platform/.cursor/rules/ci-cd.mdc

+- Part of release build process
+
+## Build Details
+- Uses esbuild executor


Same as above

brandonroberts · 2025-08-03T22:06:35Z

packages/platform/.cursor/rules/ci-cd.mdc

+## Build Details
+- Uses esbuild executor
+- Multiple entry points for different features
+- Output format: CommonJS


This is an ESM plugin

brandonroberts · 2025-08-03T22:12:09Z

apps/docs-app/sidebars.js

          label: 'Version Compatibilty',
        },
+        {
+          type: 'doc',


This should go into a different section for developers. This isn't necessarily for end users

brandonroberts · 2025-08-03T22:12:34Z

nx.json

  },
  "nxCloudAccessToken": "NDRkYzdkYmMtNDI3NS00MDI0LWFkMGQtMmI0Zjc2MTY2YzU0fHJlYWQtb25seQ==",
  "defaultBase": "beta",
+  "tui": {


Revert these

brandonroberts · 2025-08-03T22:13:54Z

packages/create-analog/.cursor/rules/ci-cd.mdc

+- Part of release build process
+
+## Testing
+- Unit tests with Jest


Suggested change

- Unit tests with Jest

- Unit tests with Vitest

brandonroberts · 2025-08-03T22:15:02Z

packages/nx-plugin/.cursor/rules/ci-cd.mdc

+## Build Details
+- TypeScript compilation with swc
+- Generators and executors for Nx workspace
+- Not tagged for release (published separately)


This package is published as part of the @analogjs/platform package.

brandonroberts · 2025-08-03T22:16:24Z

packages/storybook-angular/.cursor/rules/development.mdc

+      builder: {
+        viteConfigPath: 'path/to/vite.config.ts'
+      }


Remove

Suggested change

builder: {

viteConfigPath: 'path/to/vite.config.ts'

}

feat: initial seed of rules for cursor enhanced development

149046c

vercel bot deployed to Preview August 2, 2025 19:59 View deployment

ajitzero reviewed Aug 2, 2025

View reviewed changes

.cursor/mcp.json Show resolved Hide resolved

ajitzero reviewed Aug 2, 2025

View reviewed changes

.cursor/settings.json Outdated Show resolved Hide resolved

fix: impelmented feedback from @ajitzero

2aa1170

vercel bot deployed to Preview August 2, 2025 20:40 View deployment

fix: removed cursur rules in apps folders per request from @brandonro…

86b0a17

…berts

vercel bot deployed to Preview August 2, 2025 23:35 View deployment

brandonroberts requested changes Aug 3, 2025

View reviewed changes

feat: move rule from other PR

b3a3f6d

vercel bot deployed to Preview August 15, 2025 22:26 View deployment

feat: cursor rules for fast-glob

c71240e

vercel bot deployed to Preview August 15, 2025 22:53 View deployment

Merge remote-tracking branch 'upstream/beta' into feat/ai-rules

6a53072

vercel bot deployed to Preview August 16, 2025 15:46 View deployment

brandonroberts closed this Aug 20, 2025

Uh oh!

docs: add Cursor IDE development rules with MCP integration for enhanced developer experience #1819

docs: add Cursor IDE development rules with MCP integration for enhanced developer experience #1819

Uh oh!

Conversation

benpsnyder commented Aug 2, 2025

🎯 Overview

✨ Key Changes

🔧 Infrastructure Enhancements

📚 Package-Specific Documentation

🏗️ Development Workflow Improvements

💢 Impact

🚀 Benefits for Maintainers

📁 Files Changed

Global Configuration

Package-Specific Rules

🧪 Testing

📝 Migration Notes

Uh oh!

netlify bot commented Aug 2, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for analog-blog ready!

Uh oh!

netlify bot commented Aug 2, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for analog-docs ready!

Uh oh!

netlify bot commented Aug 2, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for analog-app ready!

Uh oh!

benpsnyder commented Aug 2, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

netlify bot commented Aug 2, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for analog-ng-app ready!

Uh oh!

Uh oh!

Uh oh!

benpsnyder commented Aug 2, 2025

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

netlify bot commented Aug 2, 2025 •

edited

Loading

netlify bot commented Aug 2, 2025 •

edited

Loading

netlify bot commented Aug 2, 2025 •

edited

Loading

benpsnyder commented Aug 2, 2025 •

edited

Loading

netlify bot commented Aug 2, 2025 •

edited

Loading