Cursor rule

1---
2description: Development workflow, build processes, and deployment guidelines
3---
4 
5# Development Workflow and Deployment
6 
7## Local Development Setup
8 
9### Prerequisites
10- **Node.js** 18+ (recommended LTS version)
11- **npm** for package management
12- **TypeScript** 5.8+
13- **Git** for version control
14 
15### Getting Started
16```bash
17# Install dependencies
18npm install
19 
20# Start development server
21npm run dev
22 
23# Build for production
24npm run build
25 
26# Preview production build
27npm run preview
28```
29 
30## Build Configuration
31 
32### Astro Configuration ([astro.config.mjs](mdc:astro.config.mjs))
33- **Astro Version**: 5.12+ with latest features
34- **Output**: Server-side rendering (SSR) with Vercel adapter 8.2+
35- **Image Service**: Sharp 0.34+ for optimized image processing
36- **Integrations**: Sitemap generation for SEO
37- **Styling**: Tailwind CSS 4.1+ via Vite plugin
38- **i18n**: Configured for 4 languages with Spanish as default
39 
40### Package Management ([package.json](mdc:package.json))
41- Use **npm** consistently for package management
42- Lock file: [package-lock.json](mdc:package-lock.json) should be committed
43- Key dependencies: Astro 5.12+, Tailwind CSS 4.1+, Vercel adapter 8.2+
44- Keep dependencies updated, especially security patches
45 
46## Deployment Strategy
47 
48### Vercel Platform
49- **Automatic deployments** from main/master branch
50- **Preview deployments** for pull requests
51- **Image optimization** enabled through Vercel's service
52- **Environment variables** configured in Vercel dashboard
53 
54### Performance Monitoring
55- Web Analytics disabled in config (can be enabled if needed)
56- Monitor Core Web Vitals through Vercel dashboard
57- Regular lighthouse audits for performance regression
58 
59## Code Quality Standards
60 
61### File Organization
62- Components in `src/components/` with descriptive names
63- Pages follow i18n structure in `src/pages/`
64- Shared styles in `src/styles/global.css`
65- Assets organized by type and purpose
66 
67### TypeScript Standards
68- Use TypeScript in component frontmatter
69- Define proper interfaces for component props
70- Leverage Astro's built-in TypeScript support
71- Configuration in [tsconfig.json](mdc:tsconfig.json)
72 
73### Version Control Best Practices
74- Keep main branch production-ready
75- Use descriptive commit messages
76- Test builds before pushing to main
77- Regular commits for iterative development
78 
79## SEO and Performance
80 
81### Search Engine Optimization
82- Sitemap automatically generated via integration
83- Proper meta tags in [Layout.astro](mdc:src/layouts/Layout.astro)
84- Structured data for event information
85- Multi-language sitemap generation
86 
87### Performance Optimization
88- Image optimization through Astro and Vercel
89- Lazy loading for below-the-fold content
90- Minimal JavaScript footprint
91- Efficient CSS delivery with Tailwind
92 
93### Monitoring
94- [robots.txt](mdc:public/robots.txt) configured for crawlers
95- Social media meta tags (Open Graph)
96- Favicon and manifest files in [public/favicon/](mdc:public/favicon/)
97 
98## Maintenance Tasks
99 
100### Regular Updates
101- **Dependencies**: Monthly security and feature updates
102- **Content**: Event information and translations
103- **Assets**: Optimize and compress new images
104- **Performance**: Regular audits and optimizations
105 
106### Content Management
107- Translation updates across all 4 languages
108- Image asset optimization and localization
109- Document updates in [public/images/docs/](mdc:public/images/docs/)
110- Calendar and event information updates
111 
112### Testing Protocol
113- Cross-browser compatibility testing
114- Mobile responsiveness validation
115- Multi-language functionality testing
116- Performance regression testing
117- Accessibility compliance verification
118 
119## Troubleshooting Common Issues
120 
121### Build Failures
122- Check Node.js version compatibility
123- Verify all translation files are complete
124- Ensure image assets exist for all referenced paths
125- Validate TypeScript compilation
126 
127### Deployment Issues
128- Verify Vercel configuration
129- Check environment variables
130- Validate build output size limits
131- Monitor function execution times
132 
133### Performance Problems
134- Audit image optimization settings
135- Review JavaScript bundle size
136- Check for unused CSS
137- Validate caching strategies
138