image
background image for teaser
Adobe Experience Manager - Edge Delivery Services Reference Project

EDS Common Blocks

DEV - PREVIEW

A modern component library for Adobe Edge Delivery Services. Build fast, accessible, and beautiful websites with production-ready blocks.
inline-text-overlay
16
10
9
16
/content/eds-common-blocks/blocks
Get Started with Blocks
https://github.com/AA-PDCOE/eds-common-blocks
GitHub

What is EDS Common Blocks?

true
true

EDS Common Blocks is a comprehensive component library built specifically for Adobe Edge Delivery Services. It provides a collection of pre-built, customizable blocks that help teams build websites faster while maintaining consistency and performance. Testing 1234

Whether you're building a marketing site, product page, or documentation portal, these blocks give you the foundation to create polished experiences without starting from scratch.

1 Section Decorators, Blocks, and Speciality Blocks

Why EDS Common Blocks?

Every block is designed with three principles in mind: speed, flexibility, and ease of use.

Performance First

Optimized for Core Web Vitals from day one. Lazy loading, minimal JavaScript, and efficient CSS ensure your pages load fast and score well on Lighthouse. Every millisecond matters, and we've measured them all.

Design Token System

A three-tier token architecture (Common → Semantic → Block) keeps your design consistent. Import tokens from Figma, switch between light and dark themes, and maintain visual harmony across every component.

Author Friendly

Full Universal Editor integration means content authors can see changes in real-time. Intuitive component models, clear options, and sensible defaults make content creation a breeze—no developer required.

How It Works

EDS Common Blocks fits seamlessly into the Edge Delivery Services workflow. Here's what you need to know.

Content Authoring

Authors create content in familiar tools like Google Docs or Microsoft Word. No special software needed. Content syncs automatically to AEM, where blocks are rendered based on simple table structures.

Each block is defined by a table in your document. The first row contains the block name, and subsequent rows contain the content. It's that simple.

For example, a CTA block might look like:

  • Row 1: "CTA"
  • Row 2: "Get Started"
  • Row 3: "/getting-started"

The system handles the rest—styling, responsiveness, and accessibility are built in.

Block Architecture

Each block is self-contained with its own JavaScript, SCSS, and JSON model. This modular approach means:

  • Easy maintenance: Update one block without affecting others
  • Clear ownership: Each block has defined inputs and outputs
  • Simple debugging: Issues are isolated to specific components

Blocks automatically receive design tokens as CSS custom properties, ensuring consistent styling without manual configuration.

Design Token System

The design token system follows a three-tier hierarchy:

  1. Common Tokens: Raw values like colors (#492728), spacing (16px), and typography (Roboto)
  2. Semantic Tokens: Contextual meanings like "primary-text-color" or "default-spacing" that reference common tokens
  3. Block Tokens: Component-specific overrides that reference semantic tokens

This hierarchy ensures that changing a brand color in one place updates it everywhere. Light and dark themes are built in—just add a data-theme="dark" attribute to any container.

Build & Deploy

Development is straightforward:

  • Run "npm start" to launch the dev server with hot reload
  • SCSS compiles automatically when you save
  • Token changes trigger a full rebuild to keep everything in sync

For production, "npm run build:prod" optimizes everything:

  • CSS is minified and autoprefixed
  • Unused styles are removed
  • Assets are optimized for delivery

Deploy through GitHub and Edge Delivery Services handles the rest—global CDN, automatic HTTPS, and instant cache invalidation.

true
true
u-cta-primary-outlined
icon-anim-crossfade

A Consistent Design Language

The design token system ensures every component speaks the same visual language. Colors, typography, spacing, and shadows are defined once and applied everywhere.

Tokens are organized into logical groups:

  • Colors: Brand primary, secondary, neutrals, and semantic colors for states

  • Typography: A modular scale from caption to display sizes

  • Spacing: Consistent rhythm from extra-small to extra-large

  • Effects: Border radii, shadows, and transitions

When you update a token, every component that uses it updates automatically. No find-and-replace, no missed instances.

Explore Design Tokens