# INVEETAIRE AI Guide

Version 1.0

This document provides implementation guidelines for any AI assistant contributing to the INVEETAIRE project.

Applicable to:

- ChatGPT
- Claude
- Gemini
- Codex
- Cursor
- Windsurf
- GitHub Copilot
- Any future AI coding assistant

---

# Single Source of Truth

All branding decisions must reference:

/assets/branding/

Specifically:

- logo/
- favicon/
- brand-colors.md
- design-system.md

Never invent branding that conflicts with these files.

---

# Brand Identity

INVEETAIRE is a

Premium Wedding Experience Platform.

The UI should feel:

- Elegant
- Calm
- Premium
- Editorial
- Luxury
- Minimal
- Timeless

Avoid making the application resemble:

- generic admin templates
- accounting software
- developer dashboards
- default Tailwind demos

---

# Brand Colors

Brand colors override framework defaults.

Primary

Charcoal

Accent

Rose Gold

Background

Ivory / White

Functional colors

Success

Warning

Danger

Info

Blue is a functional color only.

It is NOT the application's primary identity.

---

# Logo Usage

Never redesign the logo.

Never recolor it.

Never distort it.

Never recreate it.

Use the official assets inside

/assets/branding/logo/

---

# Design Language

Prefer

- generous whitespace
- subtle borders
- premium typography
- restrained accent colors
- elegant spacing
- calm layouts

Avoid

- excessive gradients
- heavy shadows
- rainbow dashboards
- overly saturated colors
- unnecessary animations

Luxury comes from restraint.

---

# UI Components

Navigation

Should primarily use Charcoal.

Buttons

Primary

Charcoal

Secondary

White

Ghost

Minimal

Premium

Rose Gold accent when appropriate.

Cards

Lightweight.

Soft borders.

Clean spacing.

Badges

Semantic first.

Premium badge may use Rose Gold.

---

# Color Hierarchy

Brand

↓

Primary Action

↓

Content

↓

Secondary Content

↓

Muted Text

↓

Border

↓

Background

Maintain this hierarchy throughout the application.

---

# Accessibility

Maintain strong readability.

Never use:

- white on ivory
- invisible borders
- low-contrast text
- decorative colors that reduce usability

Readability always takes priority.

---

# Existing UX

Do NOT redesign workflows unless explicitly requested.

Prefer:

- polish
- consistency
- refinement

over

- redesign
- feature expansion
- layout changes

---

# Development Philosophy

When making UI improvements:

1. Preserve functionality.
2. Preserve business logic.
3. Preserve database structure.
4. Improve visual quality.
5. Follow the official design system.

---

# If Unsure

When multiple design choices are possible:

Always choose the solution that best matches the official INVEETAIRE branding.

Never prioritize framework defaults over the established brand identity.

The branding assets are the source of truth.

This document has higher priority than framework defaults.

If Tailwind, Bootstrap, or any UI framework conflicts with the official INVEETAIRE branding, follow the branding.