bd495be965
All checks were successful
Deploy to Production / Build and Deploy (push) Successful in 12s
- Sidebar: dynamic brand-accent colors, brainstorm section restyled - AI chat general: popup panel with expand/collapse, hides when contextual AI open - AI chat contextual: tabs reordered (Actions first), X close button, height fix - Settings: all tabs restyled, 6 new color presets (sage, terracotta, iron, etc.) - Global color cleanup: emerald/orange hardcoded → brand-accent dynamic - Brainstorm page: orange → brand-accent throughout - PageEntry animation component added to key pages - Floating AI button: bg-brand-accent instead of hardcoded black - i18n: all 15 locales updated with new AI/billing keys - Billing: freemium quota tracking, BYOK, stripe subscription scaffolding - Admin: integrated into new design - AGENTS.md + CLAUDE.md project rules added
219 lines
4.5 KiB
Markdown
219 lines
4.5 KiB
Markdown
# 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_
|