@info-evry/astro-design

Shared design system for Asso Info Evry Astro projects. Provides a cohesive dark theme with glassmorphism effects, SF Symbols icons, and reusable Astro components.

Features

• Dark theme with glassmorphism (blur + transparency)
• CSS custom properties (design tokens) for colors, spacing, typography
• Reusable Astro components (Header, Footer, Forms, etc.)
• SF Symbols icon integration
• Mobile-first responsive design
• Accessibility-focused

Installation

Add as a git submodule:

git submodule add https://github.com/info-evry/astro-design.git design

Import the full design system in your Astro layout:

---
import '../design/src/index.css';
---

Or import specific parts:

@import '../design/src/tokens/colors.css';
@import '../design/src/components/buttons.css';

Structure

src/
├── tokens/               # CSS custom properties
│   ├── colors.css        # Color palette & gradients
│   ├── spacing.css       # Spacing scale (4px base)
│   ├── typography.css    # Fonts & text sizes
│   └── effects.css       # Radius, shadows, transitions
├── base/
│   └── reset.css         # CSS reset, SF Symbols font-face declaration
├── components/
│   ├── buttons.css       # Button variants
│   ├── cards.css         # Card components (glass, surface)
│   ├── forms.css         # Form elements & validation
│   ├── modals.css        # Modal dialogs
│   ├── sections.css      # Section layouts & containers
│   ├── header.css        # Header & navigation
│   ├── hero.css          # Hero sections
│   ├── admin.css         # Admin dashboard styles
│   ├── disclosure.css    # Accordion/disclosure groups
│   ├── kpi-stats.css     # Statistics cards
│   └── team-cards.css    # Team grid layouts
├── utilities/
│   ├── animations.css    # Keyframes & animation classes
│   └── helpers.css       # Utility classes
├── components/           # Astro components
│   ├── Header.astro      # Site header with mobile menu
│   ├── Footer.astro      # Site footer
│   ├── MobileNav.astro   # Mobile tab bar navigation
│   ├── HeroBackground.astro # Animated hero background
│   ├── SectionHeader.astro # Section title component
│   ├── FormInput.astro   # Form input with label
│   ├── FormSelect.astro  # Form select with label
│   ├── FormTextarea.astro # Form textarea with label
│   ├── FilterSelect.astro # Filter dropdown
│   ├── DataTable.astro   # Data table component
│   └── Badge.astro       # Status badge
├── integrations/
│   └── sf-symbols.ts     # Vite plugin for SF Symbols shortcodes
├── symbols/
│   └── sfsymbols.json    # SF Symbols character mappings
└── index.css             # Main entry point

Design Tokens

Colors

Token	Value	Description
--color-primary	#001BA5	Electric blue
--color-primary-light	#0ea5e9	Light blue accent
--color-bg	#000000	Background black
--color-surface	#0a0a0a	Surface color
--color-text	#ffffff	Primary text
--color-text-secondary	#a1a1aa	Secondary text
--color-text-muted	#71717a	Muted text

Spacing

4px base unit scale from --space-1 (4px) to --space-32 (128px).

Typography

• Font: SF Pro (self-hosted, subset for Latin characters)
• Sizes: --text-xs (12px) to --text-6xl (72px)
• Tracking: --tracking-tight, --tracking-normal, --tracking-wide

Components

Astro Components

---
import Header from '../design/src/components/Header.astro';
import Footer from '../design/src/components/Footer.astro';
import MobileNav from '../design/src/components/MobileNav.astro';
---

<Header
  homeUrl="/"
  navLinks={[{ href: '#about', label: 'About' }]}
  ctaHref="/join"
  ctaLabel="Join"
/>

<MobileNav
  items={[{ href: '#about', label: 'About', icon: 'info.circle' }]}
  ctaHref="/join"
  ctaLabel="Join"
  ctaIcon="person.badge.plus"
/>

<!-- SF Symbols using shortcodes -->
<span class="sfs sfs-lg" data-sfs="@sfs:checkmark.circle.fill@"></span>

<Footer />

CSS Classes

Buttons

<button class="btn btn-primary">Primary</button>
<button class="btn btn-secondary">Secondary</button>
<button class="btn btn-primary btn-lg">Large</button>
<button class="btn btn-primary btn-sm">Small</button>

Cards

<div class="glass-card card-content">
  Glassmorphism card with blur
</div>

<div class="surface-card card-content">
  Solid surface card
</div>

Forms

<form class="form">
  <div class="form-group">
    <label for="email">Email</label>
    <input type="email" id="email" placeholder="you@example.com">
  </div>
  <div class="form-group">
    <label for="message">Message</label>
    <textarea id="message"></textarea>
  </div>
</form>

Sections

<section class="section">
  <div class="container">
    <div class="section-header">
      <span class="section-label">About</span>
      <h2 class="section-title">Who We Are</h2>
      <p class="section-description">Description text</p>
    </div>
  </div>
</section>

SF Symbols

The design system includes SF Symbols support via shortcodes that are replaced at build time.

Setup

Add the integration to your astro.config.mjs:

import sfSymbols from './design/src/integrations/sf-symbols';

export default defineConfig({
  integrations: [sfSymbols()],
});

Usage

Use the @sfs:symbol.name@ shortcode format in data attributes:

<!-- Inline icon -->
<span class="sfs sfs-md" data-sfs="@sfs:checkmark@"></span>

<!-- Different sizes -->
<span class="sfs sfs-sm" data-sfs="@sfs:xmark@"></span>
<span class="sfs sfs-lg" data-sfs="@sfs:person.2.fill@"></span>
<span class="sfs sfs-xl" data-sfs="@sfs:calendar@"></span>
<span class="sfs sfs-2xl" data-sfs="@sfs:star.fill@"></span>

How It Works

1. Shortcodes like @sfs:checkmark@ are written in the HTML
2. At build time, the Vite plugin replaces them with actual Unicode characters
3. CSS uses ::before { content: attr(data-sfs); } to display the symbol
4. Font subsetting scans for shortcodes and creates an optimized font file

Available Sizes

Class	Font Size
sfs-xs	0.75rem
sfs-sm	0.875rem
sfs-md	1rem
sfs-lg	1.25rem
sfs-xl	1.5rem
sfs-2xl	2rem

Dynamic Symbols (in components)

For dynamic icon names (e.g., in MobileNav), use template expressions:

<span class="sfs sfs-lg" data-sfs={`@sfs:${item.icon}@`}></span>

The shortcode will be resolved after SSR when the actual symbol name is known.

Testing

bun test

Tests cover SF Symbols mapping and CSS token existence.

Development

# Run tests
bun test

# Watch mode
bun test --watch

Related Repositories

• astro-core - Shared code library (Router, helpers)
• astro-asso - Main association website
• astro-ndi - NDI registration platform
• astro-join - Membership portal
• astro-knowledge - Shared content

License

AGPL-3.0 - Asso Info Evry