PyScript Cursor Rule: Project Setup and Environment Configuration

This rule configures Cursor IDE for optimal PyScript development by setting up proper file associations, syntax highlighting, autocompletion, and project structure recognition for Python-in-browser projects.

# PyScript Cursor Rule: Project Setup and Environment Configuration ## Purpose This rule configures Cursor IDE for optimal PyScript development by setting up proper file associations, syntax highlighting, autocompletion, and project structure recognition for Python-in-browser projects. ## .cursorrules Content ``` # PyScript Project Setup Configuration ## File Associations and Recognition - Recognize .py files in web projects as PyScript when accompanied by HTML files containing py-script tags - Associate .html files with PyScript syntax highlighting when containing <py-script> or <py-terminal> tags - Treat .toml files as PyScript configuration when named pyscript.toml or py-script.toml ## PyScript-Specific Syntax and Imports - Enable Python syntax highlighting and IntelliSense for code within <py-script> tags in HTML - Recognize PyScript-specific imports: js, pyodide, micropip, pyscript - Provide autocompletion for PyScript DOM manipulation methods (Element, document, window) - Support for PyScript configuration object properties in HTML meta tags ## Project Structure Guidelines - Suggest standard PyScript project structure: ``` project/ ├── index.html # Main HTML file with PyScript ├── main.py # Main Python application logic ├── requirements.txt # Python package dependencies ├── pyscript.toml # PyScript configuration ├── static/ │ ├── css/ │ └── js/ └── py_modules/ # Custom Python modules ``` ## Development Environment Setup - Recommend local development server for testing (avoid file:// protocol issues) - Suggest using Python's built-in server: `python -m http.server 8000` - Enable CORS headers awareness for PyScript package loading - Configure live reload for HTML/Python file changes ## PyScript-Specific Code Completion - Provide snippets for common PyScript patterns: - Basic HTML template with PyScript CDN - Python package installation via micropip - DOM element selection and manipulation - Event handling setup - Async/await patterns for web APIs ## Error Handling and Debugging - Recognize PyScript error patterns in browser console - Suggest debugging techniques using pyscript.write() and console.log() - Highlight common PyScript pitfalls (blocking operations, package compatibility) - Provide troubleshooting for PyScript initialization errors ## Performance Optimization Hints - Warn about synchronous operations that block the main thread - Suggest lazy loading for large Python packages - Recommend code splitting for complex applications - Highlight WebAssembly optimization opportunities ## Package Management Integration - Recognize requirements.txt for PyScript-compatible packages - Validate package compatibility with Pyodide - Suggest alternatives for packages not available in PyScript - Provide warnings for packages that may cause performance issues ``` ## Benefits - **Seamless Development**: Proper syntax highlighting and autocompletion for PyScript code - **Project Organization**: Standardized structure for maintainable PyScript projects - **Error Prevention**: Early detection of common PyScript compatibility issues - **Performance Awareness**: Built-in suggestions for optimizing PyScript applications - **Development Efficiency**: Quick setup with proper tooling configuration ## Use Cases - **New PyScript Projects**: Setting up a fresh PyScript development environment - **Team Collaboration**: Ensuring consistent development setup across team members - **Educational Projects**: Teaching Python web development with proper IDE support - **Prototyping**: Rapid development of Python-based web applications - **Migration Projects**: Converting existing Python scripts to run in the browser ## Important Considerations - Ensure your local development server supports CORS for PyScript package loading - PyScript has a startup time due to WebAssembly initialization - factor this into UX design - Not all Python packages are compatible with PyScript/Pyodide - verify compatibility before use - Consider using PyScript's configuration file for complex dependency management

Created: 7/13/2025

Keywords: text snippets, AI consulting, AI Cheat Tool, AI Cheat Tool for developers, AI Cheat Tool for AI, AI Cheat Tool for ChatGPT, AI Cheat Tool for email, AI Cheat Tool for text, AI Cheat Tool for keyboard shortcuts, AI Cheat Tool for text expansion, AI Cheat Tool for text snippets, AI Cheat Tool for text replacement, AI Cheating Tool, AI Cheating Tool for developers, AI Cheating Tool for AI, AI Cheating Tool for ChatGPT, AI Cheating Tool for email, AI Cheating Tool for text, AI Cheating Tool for keyboard shortcuts, prompt cheating, AI prompt engineering, AI context engineering, context engineering, ai prompt manager, AI prompt manager, AI prompt management, ai consulting, prompt engineering consulting, generative ai consulting, ai implementation services, llm integration consultants, ai strategy for enterprises, enterprise ai transformation, ai prompt optimization, large language model consulting, ai training for teams, ai workflow automation, build ai knowledge base, llm prompt management, ai prompt infrastructure, ai adoption consulting, enterprise ai onboarding, custom ai workflow design, ai integration for dev teams, ai productivity tools, team prompt collaboration, github gists, github snippets, github code snippets, github code snippets automation, github, text expansion, text automation, snippet manager, code snippets, team collaboration tools, shared snippets, snippet sharing, keyboard shortcuts, productivity tools, workflow automation, AI-powered productivity, snippet tool for teams, team knowledge base, AI text completion, text expander for teams, snippet collaboration, multi-platform productivity, custom keyboard shortcuts, snippet sharing platform, collaborative snippet management, knowledge base automation, team productivity software, business productivity tools, snippet management software, quick text input, macOS productivity apps, Windows productivity tools, Linux productivity tools, cloud-based snippets, cross-platform snippets, team workspace tools, workflow enhancement tools, automation tools for teams, text automation software, team knowledge sharing, task automation, integrated team tools, real-time collaboration, AI for team productivity, business text automation, time-saving tools, clipboard manager, multi-device clipboard, keyboard shortcut manager, team communication tools, project management integration, productivity boost AI, text snippet sharing, text replacement software, text management tools, efficient team collaboration, AI workspace tools, modern productivity apps, custom text automation, digital workspace tools, collaborative workspaces, cloud productivity tools, streamline team workflows, smart text management, snippets AI app, snippet management for teams, shared knowledge platforms, team-focused text automation, team productivity platform, AI text expansion tools, snippet taking app, note taking app, note taking software, note taking tools, note taking app for teams, note taking app for developers, note taking app for AI, note taking app for ChatGPT, snippet software, snippet tools, snippet app for teams, snippet app for developers, snippet app for AI, snippet app for ChatGPT, AI agent builder, AI agent snippets, AI agent prompts, prompt management, prompt engineering, ChatGPT snippets, ChatGPT prompts, AI prompt optimization, AI-powered prompts, prompt libraries for AI, prompt sharing for ChatGPT, GPT productivity tools, AI assistant snippets, ChatGPT integrations, custom AI prompts, AI agent workflows, machine learning snippets, automated AI prompts, AI workflow automation, collaborative AI prompts, personalized AI agents, text snippets for ChatGPT, AI prompt creation tools, AI code snippet manager, GPT-4 text automation, AI-powered writing assistants, AI tools for developers, AI agent integrations, developer prompt snippets, AI text generation workflows, AI-enhanced productivity, GPT prompt sharing tools, team collaboration for AI, openAI integrations, text automation for AI teams, AI-powered collaboration tools, GPT-4 team tools, AI-driven text expanders, AI-driven productivity solutions, AI agent for email writing, AI agent for text expansion, AI agent for text automation, AI agent for text snippets, AI agent for text replacement, AI agent for keyboard shortcuts, AI Agent Developer, Prompt engineering, Machine Learning Engineer, AI Engineer, Customer Support, Code snippets for developers, Recruiting, AI agent for automation, AI agent for AI automation, AI agent for ChatGPT automation, AI agent for email automation, electron app for snippets, desktop snippet manager, code snippet organization, AI prompt repository, intelligent text expansion, vibe coding, real-time prompt collaboration, developer workflow optimization, team prompt library, knowledge management for developers, code snippet search, searchable code library, reusable code blocks, prompt engineering tools, prompt template management, collaborative coding, cross-team knowledge sharing, code snippet versioning, AI prompt templates, technical documentation tools, developer productivity suite, team snippet repository, AI prompt history, snippet synchronization, cloud snippet backup, markdown snippet support, syntax highlighting for snippets, code categorization, programming language snippets, language-specific code templates, contextual code suggestions, snippets with AI integration, command palette for snippets, code snippet folder organization, team snippet discovery, private and public snippets, enterprise code management, team codebase documentation, prompt engineering best practices, Vibe Coding, Vibe Coding for developers, Vibe Coding for AI, Vibe Coding for ChatGPT, Vibe Coding for email, Vibe Coding for text, Vibe Coding for keyboard shortcuts, Vibe Coding for text expansion, Vibe Coding for text snippets, Vibe Coding for text replacement, performance, security, pandas, rest, rust, api, python, react, typescript, go, docker, kubernetes, aws, azure, gcp, graphql, machine learning, tensorflow, pytorch, scikit-learn, git, gitlab, ci/cd, ios, microservices, monitoring, testing, gpt, spa, seo, accessibility, cdn

AI Prompts, ChatGPT, Code Snippets, Prompt Engineering

PyScript

PyScript Cursor Rule: Project Setup and Environment Configuration

This rule configures Cursor IDE for optimal PyScript development by setting up proper file associations, syntax highlighting, autocompletion, and project structure recognition for Python-in-browser projects.