Skip to main content
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.0
Last Updated: January 2, 2026
Status: Complete Specification

Table of Contents

  1. Design Philosophy & Principles
  2. Design System Foundation
  3. Component Library
  4. Layout System
  5. Page Specifications
  6. User Flows
  7. Responsive Design
  8. Accessibility Standards
  9. Motion & Animation
  10. Iconography
  11. Data Visualization
  12. Empty States & Error States
  13. Loading States
  14. Notifications & Feedback
  15. Form Design Patterns
  16. 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

  1. Use active voice: “Generate content” not “Content can be generated”
  2. Be specific: “3 documents ready” not “Some documents ready”
  3. Avoid jargon: “AI-powered” not “LLM-based neural generation”
  4. 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

Content area padding: 24px (desktop), 16px (tablet), 12px (mobile)

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

  1. Welcome screen
  2. Agency setup (name, website)
  3. Logo upload (skippable)
  4. First client creation (skippable)
  5. First content generation (skippable)
  6. Completion → Dashboard

6.2 Content Generation Flow

  1. Select client or navigate from dashboard
  2. Click “Generate”
  3. Enter topic
  4. (Optional) Configure advanced options
  5. (Optional) Configure distribution
  6. Click “Generate”
  7. View progress in real-time
  8. Success → Preview, Download, Distribute options
  9. Error → Retry or Edit & Retry

6.3 Document Distribution Flow

  1. From document detail, click “Distribute”
  2. Select platforms (connected only)
  3. Add custom message (optional)
  4. Preview post
  5. Click “Distribute Now”
  6. View results with links to posts

6.4 CSV Import Flow

  1. Navigate to Schedule
  2. Click “Import CSV”
  3. Download template or drop file
  4. Validation processing
  5. Review validation results (errors/warnings)
  6. Confirm import
  7. 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