Files
miracles_in_motion/assets/README.md
defiQUG 0933c8208c feat: Add contributing guidelines, license, and security policy documents
- Created CONTRIBUTING.md to outline contribution process and code of conduct.
- Added LICENSE file with MIT License and third-party licenses.
- Introduced SECURITY.md detailing vulnerability reporting and security measures.
- Established README.md in assets directory for asset management and guidelines.
- Implemented index.html as the main entry point for the website.
- Configured package.json for project dependencies and scripts.
- Developed styles.css for custom styles and responsive design.
- Set up vite.config.ts for Vite configuration and build settings.
2025-10-04 17:46:58 -07:00

158 lines
4.7 KiB
Markdown

# Required Assets for Miracles In Motion Website
This directory contains all the assets needed for the website to function properly.
## Images Directory Structure
```
assets/images/
├── logo.png # Main organization logo (200x200px recommended)
├── logo-white.png # White version for dark backgrounds
├── favicon.ico # Website favicon (32x32px)
├── hero-bg.jpg # Hero section background image (1920x1080px)
├── og-image.jpg # Open Graph image for social sharing (1200x630px)
├── team/ # Team member photos
│ ├── director-1.jpg
│ ├── director-2.jpg
│ └── volunteer-1.jpg
├── impact/ # Photos showing impact
│ ├── students-1.jpg
│ ├── supplies-1.jpg
│ └── distribution-1.jpg
└── sponsors/ # Sponsor/partner logos
├── school-district.png
├── local-business.png
└── community-org.png
```
## Documents Directory
```
assets/documents/
├── 501c3-certificate.pdf # IRS determination letter
├── financial-report.pdf # Latest annual financial report
├── form-990.pdf # Latest Form 990
├── privacy-policy.pdf # Privacy policy document
├── terms-of-service.pdf # Terms of service
├── donor-privacy-policy.pdf # Donor privacy policy
├── volunteer-handbook.pdf # Volunteer handbook
├── gift-acceptance-policy.pdf # Gift acceptance policy
├── annual-report-2024.pdf # Latest annual report
└── impact-report-2024.pdf # Impact measurement report
```
## Image Specifications
### Logo Requirements
- **Format**: PNG with transparency
- **Size**: 200x200px (minimum), SVG preferred
- **Variants**: Color, white, and dark versions
- **Usage**: Navigation, footer, social sharing
### Hero Images
- **Format**: WebP preferred, JPG fallback
- **Size**: 1920x1080px minimum
- **Quality**: High quality, compressed for web
- **Content**: Students, supplies, or community impact
### Team Photos
- **Format**: WebP preferred, JPG fallback
- **Size**: 400x400px minimum
- **Style**: Professional, consistent lighting
- **Requirements**: Signed photo releases on file
### Impact Photos
- **Format**: WebP preferred, JPG fallback
- **Size**: Various sizes for responsive design
- **Privacy**: No identifiable students without permission
- **Alt Text**: Descriptive text for accessibility
## Content Guidelines
### Photography
- Focus on positive, uplifting imagery
- Show diverse representation
- Maintain dignity and respect for all subjects
- Obtain proper releases for all identifiable people
- Follow child protection policies
### Document Standards
- **Format**: PDF preferred for official documents
- **Accessibility**: Ensure PDFs are accessible
- **Size**: Optimize for web delivery
- **Updates**: Keep current versions, archive old ones
## File Naming Convention
- Use lowercase letters
- Use hyphens for spaces
- Include version dates for documents
- Be descriptive but concise
Examples:
- `annual-report-2024.pdf`
- `hero-students-supplies.jpg`
- `team-sarah-director.jpg`
- `logo-miracles-in-motion.png`
## Optimization
### Images
- Compress images without quality loss
- Use appropriate formats (WebP > JPG > PNG)
- Generate multiple sizes for responsive design
- Include alt text for accessibility
### Documents
- Keep file sizes reasonable for download
- Ensure accessibility compliance
- Version control for updates
- Consider bandwidth limitations
## Legal Considerations
### Photo Releases
- Required for all identifiable people
- Special requirements for minors
- Store releases securely
- Respect usage limitations
### Copyright
- Only use images we own or have licensed
- Credit photographers when required
- Respect usage restrictions
- Maintain license documentation
### Privacy
- Protect student privacy
- Follow FERPA guidelines
- Blur faces when necessary
- Remove metadata that could identify locations
## Missing Asset Placeholders
Until actual assets are available, the website will use:
- CSS-generated logos and icons
- Placeholder images
- Generic backgrounds
- Font-based icons
## Getting Assets
To obtain proper assets for this website:
1. **Logo**: Contact the organization's brand manager
2. **Photos**: Coordinate with program staff for approved images
3. **Documents**: Request from legal/administrative team
4. **Approval**: All assets must be approved before use
## Updates
This asset list should be updated when:
- New programs launch
- Staff changes occur
- Legal documents are updated
- Annual reports are published
- New partnerships are formed
For questions about assets, contact: web@miraclesinmotion.org