Skip to content

feat: Ferrum Layout Engine — grid, flex, container, sidebar, spacing utilities - #5

Merged
Roy-Wanyoike merged 1 commit into
mainfrom
feat/ferrum-layout-engine-v2
Sep 1, 2026
Merged

feat: Ferrum Layout Engine — grid, flex, container, sidebar, spacing utilities#5
Roy-Wanyoike merged 1 commit into
mainfrom
feat/ferrum-layout-engine-v2

Conversation

@Roy-Wanyoike

Copy link
Copy Markdown
Owner

Summary

Implements the Ferrum Layout module from the roadmap (Beta → production-ready). A comprehensive layout utility library with Tailwind-compatible class generation.

Modules

Module Description
breakpoints 5-tier breakpoint system, responsive value resolution, useBreakpoint() hook
grid Auto-fit/auto-fill grids, responsive columns, 7 gap presets
stack HStack/VStack presets, flex direction/gap/wrap
container 6 max-width presets with centering
sidebar Responsive sidebar layouts with collapsible support
spacing 24-token scale with directional margin/padding

Key Design

  • All utilities generate Tailwind-compatible class strings
  • CSSProperties objects for dynamic/programmatic values
  • useBreakpoint() hook with debounced resize listener
  • resolveResponsiveValue<T>() walks breakpoint ladder for cascading values

Tests

  • 121 unit tests covering all modules and edge cases

Files Added

  • src/lib/ferrum-layout/ — 8 TypeScript files
  • __tests__/ferrum-layout.test.ts — 121 tests

Closes roadmap item: Ferrum Layout Beta ✅

Provides layout utilities for grid, flexbox, container, sidebar, and spacing:
- Breakpoint system with responsive value resolution
- Grid: auto-fit/auto-fill, responsive columns, gap presets
- Stack: HStack/VStack presets, flex direction/gap/wrap
- Container: max-width presets with centering
- Sidebar: responsive sidebar layouts with collapsible support
- Spacing: 24-token scale with directional margin/padding

Includes:
- useBreakpoint() React hook with resize listener
- All utilities generate Tailwind-compatible class strings
- CSSProperties objects for dynamic values
- 121 unit tests covering all modules and edge cases
@vercel

vercel Bot commented Aug 31, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
ferrum-engine Error Error Aug 31, 2026 5:41pm

@Roy-Wanyoike
Roy-Wanyoike merged commit 217e4f1 into main Sep 1, 2026
5 of 9 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant