@equal-experts/kuat-react 0.13.0 → 0.13.1

package/agent-docs/external/kuat-agent-rules/kuat-docs/rules/foundations/logo.md

@@ -0,0 +1,151 @@
+# Logo Rules
+
+Logo usage specifications for Equal Experts. This document defines logo composition, sizing, variants, and placement guidelines.
+
+---
+
+## Overview
+
+The Equal Experts logo is a core brand asset that must be used consistently and correctly.
+
+**Key Principle:** Always use official logo assets. Never recreate, modify, or distort the logo.
+
+---
+
+## Logo Composition
+
+The logo consists of two elements:
+
+1. **Brand mark:** Square brackets containing an equals sign `[=]` in blue
+2. **Wordmark:** "EQUAL EXPERTS" text in dark gray/charcoal
+
+**Rule:** These elements should always be used together unless space constraints require the brand mark only.
+
+---
+
+## Size Requirements
+
+### Minimum Sizes
+
+| Medium | Minimum Width |
+|--------|---------------|
+| Digital | 100px |
+| Print | 26.5mm |
+
+**Never scale below minimums.** If space is constrained, use brand mark only.
+
+### Recommended Sizes by Context
+
+| Context | Width |
+|---------|-------|
+| Large headers/hero areas | 150-200px |
+| Standard headers | 120-150px |
+| Footers | 100-120px |
+| Small placements | 100px minimum |
+| Favicons/Icons | Brand mark only |
+
+---
+
+## Clear Space
+
+The logo requires breathing room equal to the width of **one bracket and the equals sign** on all sides.
+
+This ensures visual prominence and brand recognition.
+
+---
+
+## Color Variants
+
+### Primary Logos (Default)
+
+Always prefer primary logos for maximum brand recognition:
+
+| Variant | File | Background | Brand Mark | Wordmark |
+|---------|------|------------|------------|----------|
+| Full color | `logo-colour.svg` | Light | Blue | Dark gray |
+| White text | `logo-white-text.svg` | Dark | Blue | White |
+
+### Monochrome Logos (Secondary)
+
+Use only when primary logos cannot be used:
+
+| Variant | File | Background | Usage |
+|---------|------|------------|-------|
+| White | `logo-monochrome-white.svg` | Dark | When primary contrast is insufficient |
+| Black | `logo-monochrome-black.svg` | Light | When monochrome is specifically required |
+
+### Selection Guide
+
+| Background | First Choice | Second Choice |
+|------------|--------------|---------------|
+| Light (white, light gray) | `logo-colour.svg` | `logo-monochrome-black.svg` |
+| Dark (navy, black, dark blue) | `logo-white-text.svg` | `logo-monochrome-white.svg` |
+| Brand color (EE Blue) | `logo-white-text.svg` | `logo-monochrome-white.svg` |
+| Photography/images | `logo-monochrome-white.svg` | Ensure sufficient contrast |
+
+---
+
+## Brand Mark Only
+
+The brand mark (without wordmark) should only be used when:
+
+1. **Space is severely limited** (favicons, small icons, social media avatars)
+2. **Shape requirements** (must fit square/circular shape)
+3. **Decorative use** (design element in presentations)
+4. **Context is clear** (obviously represents Equal Experts)
+
+---
+
+## Usage Guidelines
+
+### Do's
+
+1. **Use official assets** from the brand-assets repository
+2. **Maintain size requirements** - minimum 100px digital, 26.5mm print
+3. **Provide adequate clear space** - bracket+equals width on all sides
+4. **Choose appropriate variant** based on background color
+5. **Ensure accessibility** - sufficient contrast in all contexts
+
+### Don'ts
+
+1. **Don't transform** - No rotation, distortion, skewing
+2. **Don't modify colors** - Use only official variants
+3. **Don't alter composition** - Don't add text, separate elements
+4. **Don't compromise visibility** - No busy backgrounds, no undersizing
+5. **Don't create variations** - No custom colors or effects
+6. **Don't place on low-contrast backgrounds** - Ensure legibility
+
+---
+
+## Platform-Specific Placement
+
+For platform-specific logo placement guidance:
+
+- **Web layouts** - See [types/web/](../types/web/)
+- **Slides** - See [types/slides/](../types/slides/)
+- **Graphics** - See [types/graphics/](../types/graphics/)
+
+---
+
+## Official Logo Assets
+
+All logos are available in the [Equal Experts brand-assets repository](https://github.com/EqualExperts/brand-assets/tree/master/logo).
+
+### Primary Logos
+- `logo-colour.svg` - Full color (light backgrounds)
+- `logo-white-text.svg` - Blue mark, white text (dark backgrounds)
+
+### Monochrome Logos
+- `logo-monochrome-white.svg` - All white (dark backgrounds)
+- `logo-monochrome-black.svg` - All black (light backgrounds)
+
+### Brand Marks
+- `brand-mark-blue.svg` - Blue mark without text
+- `brand-mark-monochrome-white.svg` - White mark without text
+
+---
+
+## Related Documentation
+
+- [Brand Guidelines](./brand.md) - Brand principles
+- [Colours](./design/colours.md) - Brand color palette

package/agent-docs/external/kuat-agent-rules/kuat-docs/rules/types/web/marketing/content/README.md

@@ -0,0 +1,26 @@
+# Marketing Content Rules
+
+Content guidance for Equal Experts marketing websites, landing pages, and blog posts.
+
+---
+
+## Overview
+
+Marketing content informs, engages, and supports conversion. Load [foundations content](../../../../foundations/content/voice-and-tone.md) first, then [marketing-content.md](./marketing-content.md) for principles and content types.
+
+---
+
+## Files
+
+| File | Description |
+|------|-------------|
+| [marketing-content.md](./marketing-content.md) | Principles, tone, case studies, content types |
+| [blog-posts.md](./blog-posts.md) | Blog structure and style |
+| [seo.md](./seo.md) | SEO content and meta guidelines |
+
+---
+
+## Related
+
+- [Foundations content](../../../../foundations/content/README.md)
+- [Marketing website](../website.md)

package/agent-docs/external/kuat-agent-rules/kuat-docs/rules/types/web/marketing/content/blog-posts.md

@@ -0,0 +1,33 @@
+# Blog Posts
+
+Structure and style for Equal Experts blog content.
+
+---
+
+**Prerequisites:** [Foundations voice and tone](../../../../foundations/content/voice-and-tone.md), [marketing content](./marketing-content.md).
+
+---
+
+## Structure
+
+1. **Introduction** – Hook the reader: story, question, or clear insight. Get to the point quickly.
+2. **Problem or question** – What you're addressing. Set expectations.
+3. **Main content** – Evidence-based insights with examples. Use headings and short paragraphs.
+4. **Takeaways** – Actionable guidance the reader can use.
+5. **Call to action** – Invite further engagement (e.g. contact, subscribe, read more).
+
+---
+
+## Voice and Format
+
+- Use [foundations writing style](../../../../foundations/content/writing-style.md): active voice, plain language, "you" and "we".
+- Keep paragraphs short (3–4 sentences). Use lists and headings so content is scannable.
+- Support claims with evidence and examples. Avoid generic or unsupported statements.
+- Typical length: enough to cover the topic clearly; avoid padding. For many posts, a few hundred to ~1,500 words works well.
+
+---
+
+## Related
+
+- [Marketing content](./marketing-content.md)
+- [SEO](./seo.md)

package/agent-docs/external/kuat-agent-rules/kuat-docs/rules/types/web/marketing/content/marketing-content.md

@@ -0,0 +1,65 @@
+# Marketing Content
+
+Writing principles and content types for Equal Experts marketing websites and landing pages.
+
+---
+
+**Prerequisites:** Load [foundations](../../../../foundations/) first, especially [voice and tone](../../../../foundations/content/voice-and-tone.md).
+
+---
+
+## Overview
+
+Marketing content is written to build awareness, demonstrate expertise, and support leads and opportunities. It can be more expansive than product UI copy but should still be clear and evidence-based.
+
+---
+
+## What Marketing Content Should Do
+
+- Build awareness and reputation
+- Demonstrate expertise through evidence
+- Generate leads and opportunities
+- Educate external audiences
+
+---
+
+## Tone
+
+**Tone range:** Confident to conversational (depends on content type)  
+**Key balance:** Expertise + Clarity = Credibility
+
+Stay true to [foundations voice and tone](../../../../foundations/content/voice-and-tone.md): clear, direct, helpful. Avoid hype or vague claims.
+
+---
+
+## Content Types
+
+| Type | Guidance |
+|------|----------|
+| Case studies | Context → Challenge → Approach → Solution → Results. Start with business problem; use specific numbers. |
+| Blog posts | See [blog-posts.md](./blog-posts.md) |
+| Landing pages | Clear value proposition above the fold; scannable headings; clear CTAs; trust indicators |
+| SEO | See [seo.md](./seo.md) |
+
+### Case Studies
+
+**Structure:**
+1. Context – What was the situation?
+2. Challenge – What problems needed solving?
+3. Our approach – How did we help?
+4. Solution and implementation – What was built or changed?
+5. Results – Measurable business impact
+
+**Tips:**
+- Start with the business problem, not technology
+- Use specific numbers and evidence
+- Make it understandable by a broad audience
+
+---
+
+## Related
+
+- [Foundations content](../../../../foundations/content/README.md)
+- [Blog posts](./blog-posts.md)
+- [SEO](./seo.md)
+- [Marketing website](../website.md)

package/agent-docs/external/kuat-agent-rules/kuat-docs/rules/types/web/marketing/content/seo.md

@@ -0,0 +1,44 @@
+# SEO Content
+
+Guidance for findable, readable, and helpful marketing content.
+
+---
+
+**Prerequisites:** [Foundations content](../../../../foundations/content/README.md), [marketing content](./marketing-content.md).
+
+---
+
+## Principles
+
+- **Findable** – Use language people search for; structure and meta data support discovery.
+- **Readable** – Clear headings, short paragraphs, plain language (see [writing style](../../../../foundations/content/writing-style.md)).
+- **Helpful** – Content should answer a real question or need. Don't optimise for search at the expense of the reader.
+
+---
+
+## Page Titles and Meta Descriptions
+
+- **Title:** Clear, descriptive, and relevant to the page. Include key terms where natural. Keep within typical display length (e.g. ~50–60 characters) for important pages.
+- **Meta description:** Summarise the page and encourage a click. Match the page content; avoid generic or duplicate copy.
+
+---
+
+## Headings
+
+- Use a logical hierarchy (H1 → H2 → H3). One H1 per page.
+- Make headings descriptive so they work for both scanning and search. Use key phrases where they fit naturally; don't stuff keywords.
+
+---
+
+## Links
+
+- Use descriptive link text that states the destination or topic (good for accessibility and context).
+- Internal links help users and crawlers discover related content.
+
+---
+
+## Related
+
+- [Formatting](../../../../foundations/content/formatting.md) – Headings, links
+- [Marketing content](./marketing-content.md)
+- [Blog posts](./blog-posts.md)

package/agent-docs/external/kuat-agent-rules/kuat-docs/rules/types/web/marketing/emails.md

@@ -0,0 +1,74 @@
+# Marketing Email Rules
+
+Guidelines for Equal Experts marketing emails and campaigns.
+
+---
+
+**Status:** Placeholder - details to be defined
+
+**Prerequisites:** Load [foundations](../../../foundations/) first
+
+---
+
+## Overview
+
+Marketing emails are external communications designed to engage, inform, and convert prospects and customers.
+
+---
+
+## Key Principles
+
+1. **Value-first** - Every email should provide value to the recipient
+2. **Clear purpose** - One primary goal per email
+3. **Scannable** - Easy to read on mobile devices
+4. **Brand-consistent** - Use Equal Experts visual identity
+
+---
+
+## Email Types
+
+- **Newsletter** - Regular updates and insights
+- **Product announcements** - New features and releases
+- **Event invitations** - Webinars, conferences, meetups
+- **Nurture sequences** - Educational content series
+- **Transactional** - Confirmations, receipts (see product emails)
+
+---
+
+## To Be Defined
+
+- Email template designs
+- Header and footer specifications
+- Logo placement and sizing
+- Color usage in emails
+- Typography for email clients
+- CTA button styling
+- Mobile-first design requirements
+- Accessibility requirements (alt text, etc.)
+- Subject line guidelines
+- Preview text best practices
+
+---
+
+## Content Guidelines
+
+Follow [foundations/content/](../../../foundations/content/) for writing style.
+
+### Subject Lines
+- Keep under 50 characters for mobile
+- Be specific about content
+- Avoid spam triggers
+
+### Body Content
+- Lead with the most important information
+- Use short paragraphs
+- Include clear CTA
+- Provide value before asking
+
+---
+
+## Related Documentation
+
+- [Foundations](../../../foundations/) - Brand and design language
+- [Marketing Website](./website.md) - Website guidelines
+- [Content](../../../foundations/content/) - Writing style

package/agent-docs/external/kuat-agent-rules/kuat-docs/rules/types/web/marketing/scenarios/README.md

@@ -0,0 +1,18 @@
+# Marketing Scenarios
+
+Applied layout and design patterns for marketing website page types.
+
+---
+
+## Available Scenarios
+
+| Scenario | Use For | Base Layout |
+|----------|---------|-------------|
+| [marketing-pages.md](./marketing-pages.md) | Landing pages, pricing, features, case studies | Horizontal Navigation |
+
+---
+
+## Related Documentation
+
+- [Marketing Website](../website.md) - Marketing website guidelines
+- [Foundations Accessibility](../../../../foundations/accessibility.md) - Accessibility principles