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:- Digital Paper: Physical sheet metaphor with hard shadows
- Functional Brutalism: Visible construction, technical aesthetic
- High Contrast: Ink/Paper polarity with accent colors
- Enhanced Animations: Framer Motion for smooth interactions
- Dark Mode: Full dark mode support with CSS custom properties
Color System Implementation
Current Implementation
Uses CSS custom properties approach (recommended):Tailwind Configuration
Uses CDN Tailwind with CSS custom properties: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
- Serif font, text-5xl
- Bold, uppercase optional
- Clear hierarchy
- Sans-serif, standard weights
- Generous line-height for readability
- Dark mode variants with gray shades
- 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
- Variants: primary, secondary, ghost, danger
- Sizes: sm, md, lg
- Full-width support
- Active state animations
- Dark mode support
- Complete form component set
- Label and error support
- Focus states with hard shadows
- Dark mode variants
- Multiple color options (emerald, blue, purple, orange, red, gray)
- Dark mode support
- Proper font size (12px)
- Monospace, uppercase styling
- 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
- Full-width sections with borders
- Max-width containers (max-w-7xl)
- Generous vertical padding (py-24)
- Border separators between sections
- Hero Section
- How We Work Section
- Project Grid
- Methodology Section
- About Section
- Footer
Portal Interface
Dashboard Layout:- Grid-based project cards
- Update cards with timestamps
- Navigation to detailed views
- User menu and settings
Navigation Patterns
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: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
-
Fix Input Font
- Change PaperInput font from sans-serif to monospace
- Aligns with Paper UI principle for technical inputs
-
Fix Button Active State
- Add X translation to active state
- Should be:
active:translate-x-[2px] active:translate-y-[2px]
Medium Priority
-
Document Patterns
- Document animation patterns
- Create reusable animation utilities
- Standardize timing functions
-
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
Related Documentation
- Design System - Paper UI principles
- Application Review - Cross-application review
- Baseline Components - Standardized components
- Tailwind Configuration - Setup guide