# Platform Requirements: {{project_name}}

> Technical Boundaries & Platform Decisions

**Created:** {{date}}
**Author:** {{user_name}}
**Related:** [Product Brief](./product-brief.md)

---

## Technology Stack

### Core Platform

**CMS/Framework:** {{cms_framework}}
**Approach:** {{tech_approach}}

{{tech_approach_details}}

### Key Technologies

| Layer | Technology | Rationale |
|-------|------------|-----------|
| **Frontend** | {{frontend_tech}} | {{frontend_rationale}} |
| **Styling** | {{styling_tech}} | {{styling_rationale}} |
| **CMS/Backend** | {{backend_tech}} | {{backend_rationale}} |
{{#if database_tech}}| **Database** | {{database_tech}} | {{database_rationale}} |{{/if}}
{{#if hosting_tech}}| **Hosting** | {{hosting_tech}} | {{hosting_rationale}} |{{/if}}

---

## Plugin/Package Stack

{{#if plugins}}
| Plugin | Purpose | Status |
|--------|---------|--------|
{{#each plugins}}
| {{this.name}} | {{this.purpose}} | {{this.status}} |
{{/each}}
{{else}}
*To be determined during development*
{{/if}}

---

## Integrations

### Required Integrations

{{#each integrations}}
- **{{this.name}}:** {{this.purpose}}
{{/each}}

### Future Integrations

{{#each future_integrations}}
- **{{this.name}}:** {{this.purpose}} *({{this.timeline}})*
{{/each}}

---

## Contact Strategy

### Primary Contact Method

{{contact_strategy}}

### Contact Channels

| Channel | Priority | Implementation |
|---------|----------|----------------|
{{#each contact_channels}}
| {{this.channel}} | {{this.priority}} | {{this.implementation}} |
{{/each}}

### Future: AI Integration

{{ai_integration_notes}}

---

## UX Constraints

*These constraints inform what's possible in Phase 4 (UX Design)*

### Platform Limitations

{{#each ux_constraints}}
- {{this}}
{{/each}}

### Performance Targets

| Metric | Target | Rationale |
|--------|--------|-----------|
| **Mobile First** | {{mobile_first}} | {{mobile_rationale}} |
| **Page Load** | {{page_load_target}} | {{load_rationale}} |
| **Offline Support** | {{offline_support}} | {{offline_rationale}} |

---

## Multilingual Requirements

{{#if multilingual}}
**Languages:** {{languages}}

**Implementation:** {{multilingual_implementation}}

**URL Structure:**
```
{{url_structure}}
```

**Translation Workflow:** {{translation_workflow}}
{{else}}
*Single language site*
{{/if}}

---

## SEO Requirements

### Technical SEO

{{#each seo_requirements}}
- {{this}}
{{/each}}

### Structured Data

| Page Type | Schema Type | Key Properties |
|-----------|-------------|----------------|
{{#each structured_data}}
| {{this.page_type}} | {{this.schema_type}} | {{this.properties}} |
{{/each}}

### Local SEO (if applicable)

{{#if is_local_business}}
- [ ] Google Business Profile claimed and verified
- [ ] NAP consistency (Name, Address, Phone) across all pages
- [ ] Business category set correctly
- [ ] Service area defined
- [ ] Photos uploaded
{{else}}
*Not a local business*
{{/if}}

### Performance & Infrastructure

| Metric | Target |
|--------|--------|
| **Largest Contentful Paint (LCP)** | < 2.5 seconds |
| **First Input Delay (FID)** | < 100ms |
| **Cumulative Layout Shift (CLS)** | < 0.1 |
| **Page Load (4G)** | < 3 seconds |
| **Total Page Weight** | < 3MB |
| **Individual Image Size** | < 200KB (hero < 400KB) |
| **Mobile-Friendly** | Yes |
| **Favicon** | All sizes (16, 32, 180, 192px) |

### Security Headers

| Header | Purpose |
|--------|---------|
| **Strict-Transport-Security (HSTS)** | Force HTTPS |
| **Content-Security-Policy (CSP)** | Prevent XSS |
| **X-Content-Type-Options** | Prevent MIME sniffing |
| **X-Frame-Options** | Prevent clickjacking |
| **Referrer-Policy** | Control referrer info |
| **Permissions-Policy** | Restrict browser features |

### SEO Plugin/Tools

{{seo_tools}}

---

## Maintenance & Ownership

| Aspect | Owner | Notes |
|--------|-------|-------|
| **Content Updates** | {{content_owner}} | {{content_notes}} |
| **Technical Maintenance** | {{tech_owner}} | {{tech_notes}} |
| **Plugin Updates** | {{plugin_owner}} | {{plugin_notes}} |

---

## Development Handoff Notes

*For Phase 6 (Deliveries)*

### Environment Setup

{{environment_setup}}

### Deployment Process

{{deployment_process}}

### Key Considerations

{{#each dev_considerations}}
- {{this}}
{{/each}}

---

## Next Steps

- [ ] **Content & Language** — Define tone, languages, SEO keywords
- [ ] **Visual Direction** — Establish visual style and brand
- [ ] **Phase 2: Trigger Mapping** — Map user psychology
- [ ] **Phase 4: UX Design** — Begin design within these constraints

---

_Generated by Whiteport Design Studio_