Cursor rule

1---
2globs: public/**/*,src/assets/**/*,*.astro
3---
4 
5# Asset Management Guidelines
6 
7## Directory Structure
8 
9### Public Assets ([public/](mdc:public/))
10Static assets served directly:
11- **images/** - All static images and graphics
12- **fonts/** - Web font files (Noto Sans variants)
13- **favicon/** - Site icons and manifest
14- **robots.txt** - SEO configuration
15 
16### Source Assets ([src/assets/](mdc:src/assets/))
17Assets processed by Astro's build system:
18- **images/banner/** - Localized banner images for pages
19- **images/logos/** - Brand logos and symbols
20 
21## Image Asset Organization
22 
23### Banner Images
24Localized banner images follow strict naming convention:
25```
26banner-{page}-{device}-{locale}.webp
27 
28Examples:
29- banner-home-desktop-es.webp
30- banner-about-mobile-en.webp
31- banner-participate-desktop-pt.webp
32```
33 
34Supported pages: home, about, cali, contacts, participate, program, resources, service-team
35 
36### Carousel Images
37Organized by section with numbered sequences:
38- **about-carousel-1.webp** through **about-carousel-5.webp**
39- **info-carousel-1.webp** through **info-carousel-6.webp**  
40- **participate-carousel-1.webp** through **participate-carousel-5.webp**
41- **service-team-carousel-1.webp** through **service-team-carousel-15.webp**
42 
43### Icon Assets
44- **activity-icon-{1-8}.svg** - Activity type icons
45- **card-icon-{1-3}.svg** - Information card icons
46- **eis-icon-{1-5}.svg** - EIS (Educational Impact Study) icons
47- **participate-card-icon-{1-3}.svg** - Participation process icons
48 
49### Cultural and Wildlife Images
50Colombian flora and fauna:
51- **guacamaya.webp** - Macaw parrot
52- **tangara.webp** - Tanager bird  
53- **loro-cabeza-azul.webp** - Blue-headed parrot
54- **pato-moscovia.webp** - Muscovy duck
55- **ani-pico-liso.webp** - Smooth-billed ani
56 
57### Cali City Images
58- **cali-{1-5}.webp** - Showcasing host city
59 
60## Optimization Guidelines
61 
62### Image Formats
631. **WebP** - Primary format for photographs and complex images
642. **SVG** - For icons, logos, and simple graphics
653. **PNG** - Fallback for images requiring transparency
664. **PDF** - Documents in [public/images/docs/](mdc:public/images/docs/)
67 
68### Performance Best Practices
69```astro
70---
71import { Image } from 'astro:assets';
72import bannerImage from '@/assets/images/banner/banner-home-desktop-es.webp';
73---
74 
75<!-- Optimized image with Astro -->
76<Image 
77  src={bannerImage} 
78  alt={t.banners.home.alt}
79  width={1200}
80  height={600}
81  class="w-full h-auto"
82  loading="lazy"
83/>
84```
85 
86### Asset Loading Strategy
87- **Above-the-fold images**: Load immediately (loading="eager")
88- **Carousel and gallery images**: Lazy load (loading="lazy")
89- **Background images**: Consider using CSS with optimized formats
90- **Icons**: Inline small SVGs, load larger ones as assets
91 
92## Brand Asset Guidelines
93 
94### Official Logos
95- **logo-jamcam-color.svg** - Primary JAMCAM logo
96- **logo-jamcam-white.svg** - White variant for dark backgrounds
97- **logo-scouts-colombia.png** - Scouts de Colombia logo
98- **logo-world-scouting.png** - World Scouting logo
99 
100### Mascot and Theme Elements
101- **cholao.svg** - JAMCAM mascot in different variations
102- **trademark.svg** - Legal trademark notation
103- Various wave decorations for section separators
104 
105## Localization Considerations
106- Some images contain text and require language-specific versions
107- Banner images are fully localized for all 4 supported languages
108- Consider cultural appropriateness when adding new imagery
109- Maintain consistency with Colombian scouting visual identity
110 
111## File Naming Conventions
112- Use **lowercase** with **kebab-case** (hyphens)
113- Include **descriptive prefixes** for organization
114- Add **language suffixes** for localized assets (-es, -en, -pt, -fr)
115- Use **semantic naming** over generic numbers when possible
116- Keep filenames **concise but descriptive**
117description:
118globs:
119alwaysApply: false
120---
121