diff --git a/imgs/BRANDING.md b/imgs/BRANDING.md
new file mode 100644
index 0000000..998a895
--- /dev/null
+++ b/imgs/BRANDING.md
@@ -0,0 +1,280 @@
+# TypeDialog Brand Guidelines
+
+## Overview
+
+TypeDialog is a developer tool for type-safe interactive configuration. The brand identity combines the concepts of **dialogue** (interactive communication) and **typed** (code, type-safety, validation) through a clean, minimalist visual system.
+
+**Tagline**: "Typed dialogs for inputs, forms and schemas you can trust."
+
+---
+
+## Visual Identity
+
+### Logo Components
+
+The TypeDialog logo is composed of three essential elements that work together to communicate the brand:
+
+#### 1. Speech Bubble
+- **Purpose**: Represents dialogue and bidirectional communication
+- **Metaphor**: User-system interaction through interactive dialogs
+- **Visual**: Rounded rectangle with asymmetric pointer tail
+- **Color**: #3a3a50 (primary gray)
+
+#### 2. Angle Brackets `<>`
+- **Purpose**: Symbolizes code, typing interface, and type-safety
+- **Metaphor**: Programming languages, generics, type declarations
+- **Visual**: Chevron-style brackets flanking the cursor
+- **Color**: #ffffff (white, high contrast)
+
+#### 3. Blinking Cursor `|`
+- **Purpose**: Indicates active typing and real-time interactivity
+- **Metaphor**: User input, active engagement, responsiveness
+- **Visual**: Vertical bar with smooth 1-second blink animation
+- **Color**: #4f46e5 (accent indigo)
+
+---
+
+## Color System
+
+### Primary Colors
+
+| Color | Hex | Usage |
+|-------|-----|-------|
+| Primary Gray | #3a3a50 | Bubble, primary text, body elements |
+| Accent Indigo | #4f46e5 | Cursor, interactive elements, highlights |
+| White | #ffffff | Contrast, angle brackets, light text |
+
+### Application
+
+- **Dark Backgrounds**: Use full-color logo (all colors as defined)
+- **Light Backgrounds**: Use full-color logo (maintains contrast)
+- **Monochrome**: Use black & white variants for print/stamping
+- **Grayscale**: Bubble #404040, Brackets #808080, Cursor #606060
+
+---
+
+## Typography
+
+### Primary Font
+
+**Inter** (weights: 400 regular, 500 medium, 600 semibold)
+
+- **Origin**: Google Fonts
+- **Category**: Geometric sans-serif
+- **Characteristics**: Clean, modern, highly readable
+- **Use Cases**: All text, headings, body copy, UI
+
+### Integration
+
+```css
+/* Google Fonts import */
+@import url('https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600&display=swap');
+
+/* CSS usage */
+font-family: "Inter", -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+```
+
+### Sizing
+
+- **Headlines**: 18-24px
+- **Body Text**: 14-16px
+- **Captions**: 12px
+- **Logo Text**: 16-20px (weight: 500)
+
+---
+
+## Logo Variants
+
+### By Component
+
+- **Logo**: Icon + text combined (horizontal or vertical)
+- **Icon**: Mark/symbol only (square format)
+- **Text**: Typography only (wordmark)
+
+### By Style
+
+- **Animated**: Cursor blink (1s cycle) + text pulse (3s cycle)
+- **Static** (`_s`): No animations, always visible
+- **Monochrome** (`_bn`): Black & white, print-ready
+
+### Selection Guide
+
+| Context | Recommended | Format |
+|---------|-------------|--------|
+| Web headers | typedialog_logo_h.svg | Animated, full color |
+| App icons | typedialog_icon.svg | Animated, square |
+| Social media | typedialog_logo_h_s.svg | Static, horizontal |
+| Print/PDF | typedialog_logo_bn.svg | Static, monochrome |
+| Email | typedialog_logo_h_s.svg (export as PNG) | Static, PNG |
+| Favicon | typedialog_icon_s.svg | Static, 32-64px |
+
+---
+
+## Clear Space & Sizing
+
+### Minimum Size
+- **Icon Only**: 32×32px (visible bubble + brackets + cursor)
+- **Logo with Text**: 100×64px (readable text)
+- **Favicon**: 16×16px (simplified, tested)
+
+### Clear Space
+- **Recommended**: 10px minimum padding around logo
+- **Purpose**: Ensures logo isn't cramped; maintains visual balance
+- **Exception**: In compact layouts (favicons), space can be reduced
+
+---
+
+## Prohibited Uses
+
+### ❌ Do NOT
+
+- Remove, hide, or isolate individual components
+- Change proportions or distort the shape
+- Use unapproved colors or color combinations
+- Rotate, tilt, or flip the logo
+- Add drop shadows, blurs, or other effects
+- Resize below 32px without testing clarity
+- Change typography or substitute fonts
+- Remove animation without purpose
+- Place text too close to logo (violate clear space)
+- Use the logo on backgrounds where it lacks contrast
+
+### ✓ DO
+
+- Use the full-color version on light and dark backgrounds
+- Test clarity at the intended size before publishing
+- Maintain aspect ratio when scaling
+- Use static versions in time-sensitive or performance-critical contexts
+- Combine with Inter typography consistently
+- Preserve all three components (bubble, brackets, cursor)
+- Use monochrome variants for print and stamping
+- Reference the official specifications before implementation
+
+---
+
+## Animation Specifications
+
+### Cursor Blink
+
+```css
+@keyframes blink {
+ 0%, 50% { opacity: 1; }
+ 51%, 100% { opacity: 0; }
+}
+
+.cursor {
+ animation: blink 1s ease-in-out infinite;
+}
+```
+
+- **Duration**: 1 second
+- **Function**: ease-in-out (smooth acceleration/deceleration)
+- **Repeat**: Infinite
+- **Element**: 4×12px rectangle, #4f46e5
+
+### Text Pulse
+
+```css
+@keyframes text-pulse {
+ 0%, 100% { opacity: 1; }
+ 50% { opacity: 0.7; }
+}
+
+.text-pulse {
+ animation: text-pulse 3s ease-in-out infinite;
+}
+```
+
+- **Duration**: 3 seconds
+- **Function**: ease-in-out
+- **Repeat**: Infinite
+- **Opacity Range**: 1 → 0.7 → 1 (subtle breathing effect)
+- **Elements**: Text elements in logo variants
+
+---
+
+## File Naming Convention
+
+Format: `typedialog_[component]_[variant].svg`
+
+### Components
+- `logo` - Full logo (icon + text)
+- `icon` - Icon/mark only
+- `text` - Text/wordmark only
+
+### Variants
+- (none/default) = animated
+- `_h` = horizontal layout
+- `_s` = static (no animation)
+- `_bn` = black & white (monochrome)
+
+### Examples
+- `typedialog_logo.svg` - Vertical animated logo
+- `typedialog_logo_h.svg` - Horizontal animated logo
+- `typedialog_icon_s.svg` - Static icon (favicon base)
+- `typedialog_text_bn.svg` - Black & white text only
+
+---
+
+## Browser & Format Support
+
+### SVG Support
+- Chrome 90+
+- Firefox 88+
+- Safari 14+
+- Edge 90+
+- Mobile browsers (iOS 14+, Android Chrome)
+
+### Export Formats
+- PNG (16, 32, 64, 128, 256px)
+- ICO (favicon, multi-resolution)
+- PDF (print, vector editing)
+- EPS (Adobe Suite compatibility)
+- WebP (modern browsers)
+
+---
+
+## Accessibility
+
+- **Color Contrast**: Meets WCAG AA standards (#3a3a50 on white, #ffffff on #3a3a50)
+- **Animation**: Respects `prefers-reduced-motion` media query (disable animations if needed)
+- **SVG**: Includes title/description attributes for screen readers
+- **Scaling**: Maintains legibility from 16px to 600px+
+
+---
+
+## Usage Examples
+
+### Web - Header Logo
+```html
+
+```
+
+### App - Favicon
+```html
+
+
+```
+
+### Email - Static Logo
+```html
+
+
+```
+
+### Print - Monochrome Logo
+```html
+
+
+```
+
+---
+
+## Questions & Support
+
+For branding questions, icon modifications, or usage clarifications:
+- Review `typedialog_logo_specs.html` for technical details
+- Check `index.html` for interactive logo gallery
+- Consult `how-to-use.md` for integration examples
+
+**Remember**: The logo represents TypeDialog's commitment to type-safety, trust, and interactive excellence. Use it consistently across all touchpoints.
diff --git a/imgs/README.md b/imgs/README.md
new file mode 100644
index 0000000..d9753b9
--- /dev/null
+++ b/imgs/README.md
@@ -0,0 +1,313 @@
+# TypeDialog Logos
+
+Official logo assets for **TypeDialog** — typed dialogs for inputs, forms and schemas you can trust.
+
+## Quick Start
+
+### For Web
+
+```html
+
+
+
+
+
+
+```
+
+### For React/Vue
+
+```jsx
+import logo from '/imgs/typedialog_logo_h.svg';
+
+export default function Header() {
+ return
;
+}
+```
+
+### For Markdown/Docs
+
+```markdown
+
+```
+
+---
+
+## File Structure
+
+### 📦 Logo Variants (12 files)
+
+| Category | Files | Purpose |
+|----------|-------|---------|
+| **Animated** | `typedialog_icon.svg`, `typedialog_logo.svg`, `typedialog_logo_h.svg`, `typedialog_text.svg` | Web, digital, dynamic contexts |
+| **Static** | `typedialog_icon_s.svg`, `typedialog_logo_s.svg`, `typedialog_logo_h_s.svg`, `typedialog_text_s.svg` | Print, email, performance-critical |
+| **Monochrome** | `typedialog_icon_bn.svg`, `typedialog_logo_bn.svg`, `typedialog_logo_h_bn.svg`, `typedialog_text_bn.svg` | Print, stamping, single-color |
+
+### 🎨 Favicons (5 files)
+
+| File | Size | Use |
+|------|------|-----|
+| `favicon.svg` | Scalable | Modern browsers (primary) |
+| `favicon-16.png` | 16×16 | Legacy browsers |
+| `favicon-32.png` | 32×32 | Browser tabs, standard |
+| `favicon-64.png` | 64×64 | Apple touch icon, taskbar |
+| `favicon.ico` | Multi-res | Windows compatibility |
+
+### 📄 Documentation (4 files)
+
+- `index.html` - Interactive gallery showcase
+- `typedialog_logo_specs.html` - Technical specifications
+- `BRANDING.md` - Brand guidelines & philosophy
+- `how-to-use.md` - Integration examples & best practices
+
+---
+
+## Naming Convention
+
+### Format: `typedialog_[component]_[variant].svg`
+
+**Components**:
+- `logo` = Full logo (icon + text)
+- `icon` = Icon/mark only
+- `text` = Text/wordmark only
+
+**Variants**:
+- (none) = Animated cursor blink + text pulse
+- `_h` = Horizontal layout
+- `_s` = Static (no animations)
+- `_bn` = Black & White (monochrome)
+
+**Examples**:
+- `typedialog_logo_h.svg` → Horizontal animated logo
+- `typedialog_icon_s.svg` → Static icon (good for favicon base)
+- `typedialog_text_bn.svg` → Black & white text only
+
+---
+
+## Design Specifications
+
+### Visual Elements
+
+| Element | Value | Color |
+|---------|-------|-------|
+| Speech Bubble | Rounded rectangle | #3a3a50 |
+| Angle Brackets | `< >` chevrons | #ffffff |
+| Cursor | Vertical bar, 1s blink | #4f46e5 |
+| Text | Inter 500 | #3a3a50 |
+
+### ViewBox Sizes
+
+| Variant | ViewBox | Aspect |
+|---------|---------|--------|
+| Icon | 0 0 64 64 | 1:1 (square) |
+| Logo Vertical | 0 0 100 100 | 1:1 (square) |
+| Logo Horizontal | 0 0 200 64 | 3.125:1 (wide) |
+| Text | 0 0 140 30 | 4.67:1 (very wide) |
+
+### Color Palette
+
+```css
+--td-primary: #3a3a50; /* Primary gray */
+--td-accent: #4f46e5; /* Accent indigo */
+--td-white: #ffffff; /* Contrast */
+```
+
+---
+
+## Animation Specifications
+
+### Cursor Blink
+- **Duration**: 1 second
+- **Function**: ease-in-out
+- **Cycle**: 50% visible, 50% hidden
+- **Repeat**: Infinite
+
+### Text Pulse
+- **Duration**: 3 seconds
+- **Function**: ease-in-out
+- **Opacity Range**: 1 → 0.7 → 1
+- **Repeat**: Infinite
+
+---
+
+## Browser Support
+
+✅ **Fully Supported**:
+- Chrome 90+
+- Firefox 88+
+- Safari 14+
+- Edge 90+
+- iOS Safari 14+
+- Android Chrome
+
+---
+
+## File Sizes
+
+| Category | Typical Size | Notes |
+|----------|--------------|-------|
+| SVG (animated) | ~1.3 KB | Includes inline styles |
+| SVG (static) | ~1.1 KB | No animation overhead |
+| SVG (monochrome) | ~1.0 KB | Simplified grayscale |
+| PNG (32px) | ~2.5 KB | Optimized for web |
+| favicon.ico | ~3.5 KB | Multi-resolution |
+
+---
+
+## Usage Guide
+
+### ✅ Recommended Uses
+
+- **Web headers**: `typedialog_logo_h.svg` (animated, full color)
+- **App icons**: `typedialog_icon.svg` (animated, square)
+- **Favicons**: `typedialog_icon_s.svg` (static, optimized)
+- **Social media**: `typedialog_logo_h_s.svg` (static PNG export)
+- **Print/PDF**: `typedialog_logo_bn.svg` (monochrome, static)
+- **Email**: PNG exports of static versions only
+
+### ⚠️ Things to Avoid
+
+- Distorting proportions
+- Changing colors arbitrarily
+- Removing components
+- Using below 32px without testing
+- Adding effects (shadows, blurs)
+- Substituting fonts
+
+---
+
+## Export Options
+
+For different use cases, export SVGs as:
+
+- **PNG**: High-resolution static image (email, social)
+- **PDF**: Vector print-ready format
+- **WebP**: Modern browser optimization
+- **EPS**: Adobe Suite compatibility
+
+### Favicon Generation
+
+See `FAVICON_GENERATION.md` for step-by-step instructions on creating PNG and ICO files from the SVG source.
+
+---
+
+## Typography
+
+All TypeDialog branding uses **Inter** font (Google Fonts).
+
+```css
+@import url('https://fonts.googleapis.com/css2?family=Inter:wght@500&display=swap');
+font-family: "Inter", -apple-system, BlinkMacSystemFont, sans-serif;
+```
+
+- **Weights**: 400 (regular), 500 (medium), 600 (semibold)
+- **Sizes**: 14-24px (responsive)
+- **Letter Spacing**: 0 (neutral)
+
+---
+
+## Integration Examples
+
+### HTML + CSS
+
+```html
+
Typed dialogs for inputs, forms and schemas you can trust.
+
+
+ |
+
+```
+
+### CSS Loading
+
+```css
+/* Avoid multiple requests -->
+.logo-light { background-image: url('imgs/typedialog_logo_h.svg'); }
+.logo-dark { background-image: url('imgs/typedialog_logo_h_bn.svg'); }
+
+/* Use data URIs for very small files */
+.logo { background-image: url('data:image/svg+xml;...'); }
+```
+
+### Caching
+
+```html
+
+Typed dialogs for inputs, forms and schemas you can trust.
+For print, stamping, and monochrome contexts
+Icon clarity at different sizes
+Official TypeDialog brand colors (click to copy)
+Usage: Inter is used for all typography in TypeDialog branding. The font is clean, modern, and highly readable at all sizes.
+Import: @import url('https://fonts.googleapis.com/css2?family=Inter:wght@500&display=swap');
Font-family: font-family: Inter, -apple-system, BlinkMacSystemFont, sans-serif;