Skip to main content
This document provides a comprehensive design review of the MetaCogna.ai Landing application, documenting design patterns, component usage, and design generalities.

Project Overview

MetaCogna.ai Landing is a marketing website and client portal built with React and Vite. It showcases MetaCogna’s services, methodology, and provides authenticated portal access for clients.

Purpose

  • Marketing website for MetaCogna services
  • Client portal dashboard for project updates
  • Contact and lead generation
  • Service showcase and methodology explanation

Design Philosophy

MetaCogna.ai Landing follows Paper UI with enhanced visual elements:
  1. Digital Paper: Physical sheet metaphor with hard shadows
  2. Functional Brutalism: Visible construction, technical aesthetic
  3. High Contrast: Ink/Paper polarity with accent colors
  4. Enhanced Animations: Framer Motion for smooth interactions
  5. Dark Mode: Full dark mode support with CSS custom properties

Color System Implementation

Current Implementation

Uses CSS custom properties approach (recommended):
:root {
  --color-ink: 24 24 27;        /* Zinc 900 #18181b */
  --color-paper: 255 255 255;   /* White */
  --color-surface: 244 244 245; /* Zinc 100 #f4f4f5 */
  --color-accent: 16 185 129;   /* Emerald 500 #10b981 */
  --color-shadow: 24 24 27;     /* Zinc 900 */
  --color-dot: 228 228 231;     /* Zinc 200 */
}

.dark {
  --color-ink: 244 244 245;     /* Zinc 100 */
  --color-paper: 24 24 27;      /* Zinc 900 */
  --color-surface: 9 9 11;      /* Zinc 950 */
  --color-accent: 52 211 153;   /* Emerald 400 */
  --color-shadow: 0 0 0;        /* Black */
  --color-dot: 39 39 42;        /* Zinc 800 */
}

Tailwind Configuration

Uses CDN Tailwind with CSS custom properties:
colors: {
  ink: 'rgb(var(--color-ink) / <alpha-value>)',
  paper: 'rgb(var(--color-paper) / <alpha-value>)',
  accent: 'rgb(var(--color-accent) / <alpha-value>)',
  surface: 'rgb(var(--color-surface) / <alpha-value>)',
}
This is the recommended approach for Paper UI - uses CSS custom properties for easy theme switching.

Typography

Font Families

  • Serif (Playfair Display): Hero headings, section titles
  • Sans-Serif (Inter): Body text, descriptions
  • Monospace (JetBrains Mono): Technical labels, badges, metadata
  • Hand (Patrick Hand): Decorative elements (occasional use)

Typography Patterns

Hero Headings:
  • Large serif font (text-6xl to text-8xl)
  • Bold, tight leading (leading-[0.9])
  • High contrast with background
Section Headings:
  • Serif font, text-5xl
  • Bold, uppercase optional
  • Clear hierarchy
Body Text:
  • Sans-serif, standard weights
  • Generous line-height for readability
  • Dark mode variants with gray shades
Technical Labels:
  • Monospace, uppercase
  • Small size, wide tracking
  • Badge-style presentation

Component Inventory

Core Components

PaperCard
  • Enhanced with Framer Motion animations
  • Supports headerAction prop
  • noPadding option
  • Smooth fade-in animations
PaperButton
  • Variants: primary, secondary, ghost, danger
  • Sizes: sm, md, lg
  • Full-width support
  • Active state animations
  • Dark mode support
PaperInput, PaperTextArea, PaperSelect
  • Complete form component set
  • Label and error support
  • Focus states with hard shadows
  • Dark mode variants
PaperBadge
  • Multiple color options (emerald, blue, purple, orange, red, gray)
  • Dark mode support
  • Proper font size (12px)
  • Monospace, uppercase styling
PaperModal
  • Full modal implementation
  • Overlay with backdrop blur
  • Smooth animations
  • Close button in header

Application Components

  • HeroSection: Landing page hero with animated text
  • MethodologySection: Three-pillar explanation with visualizations
  • AboutSection: Philosophy and team information
  • ProjectGrid: Project showcase grid
  • ServicesBase: Service offerings display
  • PortalDashboard: Authenticated client portal
  • DecisionLog: Decision tracking interface
  • ContactModal: Lead generation form
  • Footer: Site footer with links

Layout Patterns

Landing Page Structure

Hero Section:
  • Full-viewport height
  • Centered content
  • Animated background elements
  • Call-to-action buttons
Content Sections:
  • Full-width sections with borders
  • Max-width containers (max-w-7xl)
  • Generous vertical padding (py-24)
  • Border separators between sections
Section Organization:
  1. Hero Section
  2. How We Work Section
  3. Project Grid
  4. Methodology Section
  5. About Section
  6. Footer

Portal Interface

Dashboard Layout:
  • Grid-based project cards
  • Update cards with timestamps
  • Navigation to detailed views
  • User menu and settings

Landing Page Navigation

  • Fixed Header: Top navigation bar
  • Smooth Scrolling: Anchor links to sections
  • View State Management: React state for portal/landing toggle

Portal Navigation

  • Tab-based navigation (Projects, Decisions, Gallery, Services)
  • View state management
  • Modal-based detail views

Animation Patterns

Hero Animations

  • Typing Effect: Terminal-style typing animation
  • Glitch Effect: Text glitch animation for technical feel
  • Morphing Separators: Animated line separators
  • Fade-in Animations: Smooth content reveals

Component Animations

  • Card Fade-in: Cards fade in with slight upward motion
  • Modal Transitions: Scale and fade for modals
  • Hover Effects: Shadow and color transitions
  • Button Interactions: Active state translations

Background Patterns

  • Dot Pattern: Radial gradient dot pattern background
  • Decorative Elements: Geometric shapes with low opacity
  • Animated Gradients: Subtle gradient animations

Unique Design Features

Glitch Effect

Text glitch animation for technical/terminal aesthetic:
.glitch-text::before,
.glitch-text::after {
  content: attr(data-text);
  position: absolute;
  // Glitch styling
}

Terminal Aesthetic

  • Terminal-style badges and labels
  • Monospace fonts for technical content
  • Terminal cursor animations
  • Console-style interfaces

Three-Pillar Visualization

Methodology section uses custom SVG visualizations:
  • Curiosity (Math visualization)
  • Discipline (Tensor visualization)
  • Delivery (Chaos visualization)

Marquee Text

Animated scrolling text banner:
  • Technical status messages
  • Continuous loop animation
  • Monospace font

Responsive Design

Breakpoints

  • Mobile-first approach
  • md: breakpoint for tablets and up
  • Grid layouts adapt to screen size
  • Text sizes scale responsively

Mobile Patterns

  • Stacked layouts on mobile
  • Reduced padding on small screens
  • Touch-friendly button sizes
  • Simplified navigation

Dark Mode Implementation

Theme Toggle

  • Toggle button in header
  • LocalStorage persistence
  • System preference detection
  • Smooth theme transitions

Dark Mode Colors

All colors adapt via CSS custom properties:
  • Ink/Paper polarity flips
  • Accent colors brighten in dark mode
  • Surface colors darken appropriately
  • Text colors adjust for contrast
Full dark mode support with proper color mappings - this is the recommended approach.

Form Patterns

Contact Forms

  • PaperCard containers
  • PaperInput/PaperTextArea components
  • Validation and error states
  • Submit with loading states

Portal Forms

  • Settings forms
  • Project configuration
  • Update forms

Component Usage Patterns

Card Usage

  • Hero cards with large content
  • Feature cards in grids
  • Update cards in portal
  • Service cards with descriptions

Button Usage

  • Primary: Main CTAs (Explore Services, Contact)
  • Secondary: Alternative actions
  • Ghost: Tertiary links
  • Full-width: Form submissions

Badge Usage

  • Status indicators (ACTIVE, ONLINE)
  • Section labels (PHILOSOPHY, SERVICES)
  • Metadata tags
  • Color-coded by purpose

Consistency Assessment

Strengths

  • ✅ Excellent dark mode implementation
  • ✅ Consistent use of Paper UI components
  • ✅ Proper CSS custom properties approach
  • ✅ Enhanced animations improve UX
  • ✅ Complete component set
  • ✅ Responsive design patterns

Areas for Improvement

  • ⚠️ Input font should be monospace (currently uses sans-serif)
  • ⚠️ Button active state should include X translation (currently only Y)
  • ⚠️ Some decorative elements could be simplified
Overall excellent implementation - serves as a good baseline for other applications.

Recommendations

High Priority

  1. Fix Input Font
    • Change PaperInput font from sans-serif to monospace
    • Aligns with Paper UI principle for technical inputs
  2. Fix Button Active State
    • Add X translation to active state
    • Should be: active:translate-x-[2px] active:translate-y-[2px]

Medium Priority

  1. Document Patterns
    • Document animation patterns
    • Create reusable animation utilities
    • Standardize timing functions
  2. Component Documentation
    • Document all custom components
    • Create usage examples
    • Provide prop documentation

Design Generalities Summary

Overall Approach: Polished, animated, professional marketing site with technical aesthetic Key Characteristics:
  • Enhanced animations and interactions
  • Full dark mode support
  • Technical/terminal aesthetic elements
  • Professional marketing presentation
  • Smooth user experience
Strengths: Best-in-class dark mode, complete component set, excellent animations Weaknesses: Minor inconsistencies (input font, button active state) Recommended As: Baseline reference for other applications