Normalized for Mintlify from
knowledge-base/aiconnected-apps-and-modules/modules/aiConnected-paper/paper-ui-ux-spec.mdx.Content Strategist
UI/UX Design Specification
Version: 2.0Last Updated: January 2, 2026
Status: Complete Specification
Table of Contents
- Design Philosophy & Principles
- Design System Foundation
- Component Library
- Layout System
- Page Specifications
- User Flows
- Responsive Design
- Accessibility Standards
- Motion & Animation
- Iconography
- Data Visualization
- Empty States & Error States
- Loading States
- Notifications & Feedback
- Form Design Patterns
- PDF Output Design
1. Design Philosophy & Principles
1.1 Core Philosophy
Content Strategist is a professional B2B SaaS tool designed for marketing agencies and their enterprise clients. The interface must convey:- Trust & Professionalism: Clean, polished, enterprise-ready
- Efficiency: Minimize clicks, maximize productivity
- Clarity: Complex AI processes made understandable
- Confidence: Users should feel in control at all times
1.2 Design Principles
1.2.1 Clarity Over Cleverness
Every interface element should be immediately understandable. Avoid:- Ambiguous icons without labels
- Jargon or technical terms without context
- Hidden functionality
1.2.2 Progressive Disclosure
Show only what’s needed at each step. Advanced options should be discoverable but not overwhelming.1.2.3 Immediate Feedback
Every user action should have visible feedback within 100ms:- Button click → Visual press state
- Form submission → Loading indicator
- Error → Inline message at point of error
1.2.4 Contextual Help
Help should be available where needed, not buried in documentation:- Tooltips on complex fields
- Inline hints below inputs
- “Learn more” links to relevant docs
1.2.5 Consistent Patterns
Similar actions should look and behave the same way throughout:- All primary actions use the same button style
- All forms follow the same layout patterns
- All tables have consistent sorting/filtering
1.3 Voice & Tone
Interface Copy Guidelines
Writing Rules
- Use active voice: “Generate content” not “Content can be generated”
- Be specific: “3 documents ready” not “Some documents ready”
- Avoid jargon: “AI-powered” not “LLM-based neural generation”
- Use sentence case: “Advanced options” not “Advanced Options”
2. Design System Foundation
2.1 Color System
2.1.1 Primary Palette
2.1.2 Neutral Palette
2.1.3 Semantic Colors
2.1.4 Dark Mode Palette
2.1.5 Color Usage Guidelines
2.1.6 Contrast Requirements
All text must meet WCAG 2.1 AA standards:- Normal text (< 18px): 4.5:1 minimum contrast ratio
- Large text (≥ 18px or ≥ 14px bold): 3:1 minimum contrast ratio
- UI components: 3:1 minimum contrast ratio
2.2 Typography
2.2.1 Font Families
2.2.2 Type Scale
2.2.3 Type Styles
2.3 Spacing System
2.3.1 Base Unit
All spacing uses a 4px base unit for consistency.2.3.2 Common Spacing Patterns
2.4 Elevation & Shadows
2.4.1 Shadow Scale
2.4.2 Elevation Usage
2.5 Border Radius
2.6 Z-Index System
3. Component Library
3.1 Buttons
3.1.1 Button Variants
3.1.2 Button Sizes
3.1.3 Button States
- Normal: Default appearance
- Hover: Slightly darker, subtle lift (translateY(-1px))
- Active/Pressed: Darker, no lift
- Focus: Focus ring visible
- Loading: Spinner icon, text changes to “Loading…”, disabled
- Disabled: Reduced opacity, cursor: not-allowed
3.2 Form Elements
3.2.1 Text Input
3.2.2 Select Dropdown
- Closed state shows selected value with chevron
- Open state shows dropdown with options
- Support for option groups and separators
- Max height: 320px with scroll
- Hover highlight on options
- Checkmark on selected option
3.2.3 Textarea
- Min-height: 100px
- Resize: vertical only
- Character counter appears when > 50% of max
3.2.4 Checkbox & Radio
- 16x16px hit area minimum (44x44px recommended for touch)
- Clear visual distinction between checked/unchecked
- Support for indeterminate state (checkbox only)
- Optional help text below label
3.2.5 Toggle Switch
- Width: 44px, Height: 24px
- Knob: 20px diameter
- Smooth animation (150ms)
- Clear on/off states
3.2.6 Tag/Chip Input
- Tags displayed inline with input
- Remove tag: click X or backspace
- Add tag: Enter key
- Support for max tags limit
3.3 Cards
3.3.1 Basic Card
3.3.2 Document Card
- Thumbnail preview (16:9 aspect ratio)
- Title and metadata
- Status badge
- Action buttons
- Hover: elevated shadow, subtle scale
3.3.3 Client Card
- Logo placeholder
- Company name and info
- Stats row (documents, scheduled, drafts)
- Last activity timestamp
- Action buttons
3.3.4 Stat Card
- Large number display
- Label text
- Optional trend indicator (up/down/neutral)
- Optional icon
3.4 Navigation
3.4.1 Sidebar Navigation
- Width: 256px (collapsible to 64px)
- Logo area at top
- Search/command palette trigger
- Grouped nav items with section labels
- Active state: background highlight + left border
- User menu at bottom
3.4.2 Top Navigation Bar
- Height: 64px
- Hamburger toggle (mobile)
- Logo/title
- Search trigger
- Notifications dropdown
- User menu dropdown
3.4.3 Breadcrumbs
- Separator: ”/” or ”›”
- Current page not clickable
- Truncation for long paths
3.4.4 Tabs
- Active: primary color text + bottom border
- Inactive: gray text
- Hover: slightly darker + background
3.5 Tables
3.5.1 Data Table
- Header row with sort indicators
- Checkbox column for selection
- Hover highlight on rows
- Row actions menu
- Pagination controls
- Bulk actions bar when rows selected
3.5.2 Table Row Actions
- Overflow menu (⋮) for actions
- Common actions: View, Edit, Duplicate, Delete
- Destructive actions in red
3.6 Modals & Dialogs
3.6.1 Standard Modal
- Widths: 480px (sm), 640px (md), 800px (lg), 90vw (xl)
- Max-height: 90vh with scroll
- Header with title and close button
- Footer with action buttons
- Backdrop click to close (optional)
- ESC key to close
3.6.2 Confirmation Dialog
- Centered, smaller width
- Icon indicating type (warning, danger, info)
- Clear question
- Cancel + Confirm buttons
- Destructive confirm in red
3.6.3 Drawer/Slide-over
- Slides from right
- Widths: 400px (sm), 500px (md), 640px (lg)
- Same backdrop behavior as modal
3.7 Status Indicators
3.7.1 Status Badges
3.7.2 Progress Indicators
- Linear: 8px height, rounded, animated shimmer
- Circular: 32/48/64/96px sizes, stroke proportional
- Step: Numbered steps with connectors
4. Layout System
4.1 Grid System
4.1.1 Base Grid
4.2 Page Structure
4.2.1 Standard Page Layout
5. Page Specifications
5.1 Dashboard
- Welcome message with user name
- 4 stat cards (Clients, Documents, Scheduled, Generating)
- Recent Documents list (5 items)
- Quick Actions panel
- Activity Chart (30-day view)
5.2 Client List
- Search and filter bar
- Card grid view (4 columns desktop, 2 tablet, 1 mobile)
- Pagination
- Empty state for no clients
5.3 Client Detail
- Header with logo, name, industry, location
- Tab navigation (Overview, Documents, Schedule, Settings)
- Overview: Stats, Recent Documents, Upcoming Schedule, Details panel
- Documents: Filterable table
- Schedule: Calendar or list view
- Settings: Client-specific configuration
5.4 Content Generation
- Topic input (required)
- Advanced options (collapsible): Template, Tone, Keywords, Services, Custom Direction
- Distribution settings (collapsible): Auto-distribute toggle, Platform selection
- Generate button
- Progress view with real-time updates
- Completion view with preview and next actions
5.5 Document View
- Back navigation
- Title and metadata header
- Status badge
- Action buttons (Download, Share, Distribute)
- PDF preview with page navigation
- Generation details panel
- Distribution status panel
5.6 Schedule Management
- Calendar view (monthly with day detail)
- List view alternative
- Add/Import buttons
- Day detail panel shows scheduled items
- Edit/Cancel actions on items
5.7 Settings Pages
- Tabbed interface: General, Branding, Integrations, API Keys
- General: Agency info, preferences
- Branding: Logo uploads, color customization, preview
- Integrations: Social platform connections
- API Keys: Key management with copy/regenerate
6. User Flows
6.1 First-Time User Onboarding
- Welcome screen
- Agency setup (name, website)
- Logo upload (skippable)
- First client creation (skippable)
- First content generation (skippable)
- Completion → Dashboard
6.2 Content Generation Flow
- Select client or navigate from dashboard
- Click “Generate”
- Enter topic
- (Optional) Configure advanced options
- (Optional) Configure distribution
- Click “Generate”
- View progress in real-time
- Success → Preview, Download, Distribute options
- Error → Retry or Edit & Retry
6.3 Document Distribution Flow
- From document detail, click “Distribute”
- Select platforms (connected only)
- Add custom message (optional)
- Preview post
- Click “Distribute Now”
- View results with links to posts
6.4 CSV Import Flow
- Navigate to Schedule
- Click “Import CSV”
- Download template or drop file
- Validation processing
- Review validation results (errors/warnings)
- Confirm import
- Success → View schedule
7. Responsive Design
7.1 Breakpoint Behavior
Desktop (≥1280px)
- Full sidebar (256px)
- Multi-column layouts
- Full-featured tables
Tablet (768px - 1279px)
- Collapsed sidebar (64px icons only, hover to expand)
- Reduced columns
- Tables remain but with horizontal scroll
Mobile (<768px)
- Hidden sidebar (hamburger menu)
- Bottom tab navigation
- Single column layouts
- Tables convert to cards
- Modals become full-screen
7.2 Touch Targets
- Minimum: 44x44px
- Recommended: 48x48px
- Spacing between targets: minimum 8px
8. Accessibility Standards
8.1 WCAG 2.1 AA Compliance
8.2 Implementation
- Skip links for main content
- Focus visible on all interactive elements
- Screen reader announcements for dynamic content
- Proper heading hierarchy
- Form field labels and error associations
8.3 Reduced Motion
9. Motion & Animation
9.1 Duration Scale
9.2 Easing Functions
9.3 Common Animations
- fadeIn: opacity 0 → 1
- slideUp: translateY(16px) → 0 with fade
- scaleIn: scale(0.95) → 1 with fade
- slideFromRight: translateX(100%) → 0
- pulse: opacity animation for loading
- spin: 360° rotation for spinners
10. Iconography
10.1 Icon Library
Use Lucide Icons (MIT licensed)10.2 Icon Sizes
10.3 Icon Guidelines
- Always use with labels for primary actions
- Maintain consistent style (don’t mix filled/outlined)
- Use appropriate size for context
- Ensure sufficient contrast
11. Data Visualization
11.1 Chart Colors
11.2 Chart Types
- Bar charts (horizontal for comparisons)
- Line charts (trends over time)
- Donut charts (proportions)
12. Empty States & Error States
12.1 Empty States
- Relevant icon (48px)
- Clear headline
- Helpful description
- Primary action button
- Optional secondary action or link
12.2 Error States
Page-Level
- Warning icon
- “Something went wrong”
- Helpful description
- Retry button
- Support contact info
404 Page
- Search icon
- “404 - Page not found”
- Description
- Go to Dashboard button
13. Loading States
13.1 Page Loading
- Skeleton screens matching content layout
- Subtle pulse/shimmer animation
13.2 Button Loading
- Spinner icon
- Text changes to action verb (“Generating…”)
- Button disabled during loading
13.3 Inline Loading
- Centered spinner with message
- Used within cards/sections
14. Notifications & Feedback
14.1 Toast Notifications
Position: Top-right, 24px from edges
Max visible: 3 (newest on top)
Animation: Slide in from right
14.2 Inline Alerts
- Full-width within content area
- Dismissible with X button
- Same color scheme as toasts
15. Form Design Patterns
15.1 Form Layout
- Single column default (max 600px)
- Two columns for related short fields
- 24px between fields
- 32px between sections
15.2 Validation
- Real-time validation on blur
- Error messages immediately below field
- Error summary at top on submit failure
- Success indicator (checkmark) for valid fields
15.3 Required Fields
- Asterisk (*) after label
- Never make optional the minority
16. PDF Output Design
16.1 Page Specifications
- Size: Letter (8.5” x 11”)
- Margins: 0.75” all sides
- Body text: 11pt, 1.5 line height
16.2 Cover Page
- Full-bleed cover image option
- Title: 42pt, bold
- Subtitle: 16pt, regular
- Logo: Bottom left
- Date: Next to logo
16.3 Content Pages
- Header: Logo + document title + page number
- Section labels: 11pt, uppercase, secondary color
- Section titles: 26pt, bold, primary color
- Drop caps: 3.5em, primary color
- Statistics callouts: Full width, light background
- Pull quotes: Centered, larger text, attribution
- Footer: Copyright text + page number
16.4 Visual Elements
- Charts: Full content width, brand colors
- Callout boxes: Colored left border + light background
- Images: Full width or half width with caption
16.5 Color Application
- Primary: Headers, drop caps, stats
- Secondary: Section labels, accents
- Accent: Links, secondary highlights
- Grays: Body text, captions, borders
Appendix A: Quick Reference
Button Variants
Spacing Scale
Typography Scale
END OF UI/UX DESIGN SPECIFICATION