# Website Design System Documentation ## Overview This document describes the unified design system for the Yogesh Wadadekar website. The system provides consistent styling, components, and functionality across all pages. ## File Structure ``` css/ ├── variables.css # CSS custom properties (colors, typography, spacing) ├── components.css # Reusable UI component styles └── style.css # Main stylesheet (imports above + base styles) js/ └── main.js # JavaScript utilities (theme toggle, navigation, etc.) src/ └── navbar-template.html # Copy-paste navigation templates ``` ## Quick Start ### For New Pages 1. Copy the head section template from `src/navbar-template.html` 2. Add the navigation bar 3. Add your content 4. Add the footer 5. Include the scripts before `` ### Minimal Example ```html Page Title | Yogesh Wadadekar

Page Title

``` ## CSS Variables Reference ### Colors | Variable | Description | Light Mode | Dark Mode | |----------|-------------|------------|-----------| | `--color-primary` | Primary brand color | #1a365d | #1a365d | | `--color-accent` | Accent/highlight | #3182ce | #63b3ed | | `--color-bg-primary` | Main background | #ffffff | #1a202c | | `--color-text-primary` | Main text | #1a202c | #f7fafc | | `--color-link` | Link color | #2b6cb0 | #63b3ed | ### Typography | Variable | Value | |----------|-------| | `--font-heading` | Inter, system fonts | | `--font-body` | Source Sans Pro, system fonts | | `--font-size-base` | 1rem (16px) | | `--font-size-lg` | 1.125rem (18px) | | `--font-size-xl` | 1.25rem (20px) | ### Spacing | Variable | Value | |----------|-------| | `--spacing-1` | 0.25rem (4px) | | `--spacing-2` | 0.5rem (8px) | | `--spacing-4` | 1rem (16px) | | `--spacing-6` | 1.5rem (24px) | | `--spacing-8` | 2rem (32px) | ## Component Classes ### Cards ```html
Content here
``` ### Feature Cards (Clickable) ```html

Title

Description

``` ### Section Titles ```html

Section Name

``` ### Badges ```html Research Topic 2025 ``` ### Buttons ```html Button Text ``` ### Contact Info Box ```html
Email
email@example.com
``` ## JavaScript Features ### Theme Toggle The theme toggle is automatic. Just include: ```html ``` ### Back to Top Automatically added by `main.js`. Shows after scrolling 300px. ### Smooth Scrolling All anchor links (``) automatically smooth scroll. ### Last Modified Date ```html ``` Automatically populated with the page's last modified date. ## Dark Mode Dark mode works in three ways: 1. **System preference**: Automatically follows `prefers-color-scheme` 2. **Manual toggle**: Users can click the theme toggle button 3. **Persistent**: User preference is saved in localStorage To force a specific theme: ```html ``` ## For Subdirectory Pages When creating pages in subdirectories (e.g., `wildlife/`, `agn2021/`): 1. Adjust CSS path: `../css/style.css` 2. Adjust JS path: `../js/main.js` 3. Adjust navigation links: `../index.html`, etc. See the subdirectory template in `src/navbar-template.html`. ## Browser Support - Chrome 90+ - Firefox 88+ - Safari 14+ - Edge 90+ ## Accessibility - All interactive elements have focus styles - Color contrast meets WCAG AA standards - Semantic HTML structure - ARIA labels on buttons - Skip to content link (optional) ## Print Styles Print-specific styles hide navigation and adjust colors for printing. --- *Last updated: December 2024*