Axiom01: Build Faster, Code Cleaner, Design Smarter.

The semantic-first UI framework that empowers you to create stunning, accessible, and high-performance websites with minimal effort. Focus on your content, we'll handle the beauty.

A Framework with a Philosophy

Axiom01 stands against the complexity and bloat of modern web development. We believe a framework should empower you, not dictate. Our philosophy is simple: **write clean, semantic HTML, and let Axiom handle the beauty.**

Semantic First

Craft meaningful HTML. Axiom styles it beautifully, reducing boilerplate and improving SEO.

Minimal Classes

One class per component. Achieve complex designs without a cascade of utility classes.

Accessible by Default

WCAG 2.1 AA compliance out of the box. Build inclusive experiences effortlessly.

The Cascading Spacing System

Axiom's layout is built on a simple, powerful idea: a single source of truth for all spacing: the CSS variable --a-space-unit. This variable generates a comprehensive, consistent scale (from --a-space-xs to --a-space-xxl) used for padding, margin, and gap properties throughout the framework. This system ensures visual harmony and simplifies responsive design. Adjust the slider below to see how changing this one value can globally and consistently rescale the layout of an entire application, making design adjustments effortless.

Card (padding: --a-space-l)
Button (padding: --a-space-m)
Tag (padding: --a-space-s)

The container above uses gap: var(--a-space-m). Each item's margin and padding are derived from the same unit.

Everything You Need, Nothing You Don't

Axiom01 is packed with features to help you build beautiful, responsive websites with ease.

20+ Themes

Choose from a variety of pre-built themes, or create your own with our theme wizard.

Responsive Design

All components are designed to work on any screen size, from mobile to desktop.

Lightweight

The core framework is just ~12KB (gzipped), so your sites will load lightning fast.

The Color System: Your Automatic Designer

Axiom's color system is designed to do the heavy lifting for you. By simply defining a primary color, Axiom uses color theory to automatically calculate a full, harmonious palette. It generates secondary, tertiary, and analogous colors, plus accessible "on-container" text colors for each. This means you can build beautiful, consistent, and accessible interfaces right out of the box without having to be a color expert. For a deeper dive, visit the Advanced Color Details page or use the Theme Wizard.

Base Palette

Primary

var(--a-color-primary)

Secondary

var(--a-color-secondary)

Tertiary

var(--a-color-tertiary)

Surface

var(--a-color-surface)

On Surface

var(--a-color-on-surface)

Outline

var(--a-color-outline)

Container Palette

These colors are designed for backgrounds. The "on-container" colors are guaranteed to be accessible on their corresponding container color.

Text

Primary Container

var(--a-color-primary-container)

Text

Secondary Container

var(--a-color-secondary-container)

Text

Tertiary Container

var(--a-color-tertiary-container)

Text

Error Container

var(--a-color-error-container)

Analogous Palette

Analogous 1

var(--a-color-analogous-1)

Analogous 2

var(--a-color-analogous-2)

Text

Analogous 1 Container

var(--a-color-analogous-1-container)

Text

Analogous 2 Container

var(--a-color-analogous-2-container)

Semantic Palette

Success

var(--a-color-success)

Warning

var(--a-color-warning)

Error

var(--a-color-error)

Info

var(--a-color-info)

Predefined Gradients

Primary

var(--a-gradient-primary)

Sunset

var(--a-gradient-sunset)

Ocean

var(--a-gradient-ocean)

Forest

var(--a-gradient-forest)

Greyscale Palette

gray-1

gray-5

gray-10

gray-15

gray-20

gray-25

gray-30

gray-36

Theme Explorer

Axiom's theming is powered by CSS variables. This allows for deep customization that goes beyond simple color changes. Each theme can have its own unique typography, spacing, and border styles. Select a theme below to see the entire page transform instantly.

A clean, professional, and modern theme perfect for corporate websites and applications.

Get Started in Seconds

Axiom is a free and open-source framework, released under the MIT License. You can use it for any personal or commercial project. Start building your next project today with one of the options below.

Use the CDN

The quickest way to get started. Just add the following stylesheet link to the <head> of your HTML file.

<link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/Sol-Roth-Media/axiom01@v1.0.0/css/axiom.css">
Note: Replace `v1.0.0` with the actual release version you intend to use.

Install via npm

For projects using a JavaScript build system, install Axiom01 via npm.

npm install axiom01-ui
Then, import the CSS into your project's main JavaScript or CSS file: import 'axiom01-ui/dist/axiom.min.css';

Typography: Expressive and Readable

Axiom's typography system is crafted for optimal readability and visual hierarchy, ensuring your content is both beautiful and easy to consume. We provide a comprehensive set of semantic text styles, from headings to paragraphs, designed to work harmoniously across all devices.

Headings

Heading 1 with a Subtitle

Heading 2 with a Subtitle

Heading 3

Heading 4

Heading 5
Heading 6

Paragraphs & Text Styles

This is a lead paragraph, often used for introductory text that needs to stand out.

This is a standard paragraph of text. Axiom uses a clean, modern font stack that is optimized for all devices, ensuring legibility and a consistent reading experience.

Text can be bold, italic, or underlined. You can also use muted text for less emphasis.

This is small text, often used for disclaimers or copyright information.

Lists

Unordered List

  • List Item 1
  • List Item 2
  • List Item 3

Ordered List

  1. First item
  2. Second item
  3. Third item

Blockquote

"This is a blockquote. It is used to highlight a quote or a key piece of information, providing visual separation and emphasis."
— Famous Author

Code Snippets

Inline code: const example = "hello";

Block code:

<!-- Axiom Card Example -->
<article class="card">
    <header>
        <img src="img/axiom.jpeg" alt="Axiom Logo">
        <h3>Axiom Card</h3>
    </header>
    <main>
        <p>This is a simple card component.</p>
    </main>
    <footer>
        <button class="primary">Learn More</button>
    </footer>
</article>

For a deeper dive into font families, weights, sizes, line heights, and advanced text utilities, see the Advanced Typography Guide.

Accessible by Default

Axiom is built with accessibility at its core. We follow the Web Content Accessibility Guidelines (WCAG) 2.1 AA to ensure that your applications can be used by everyone, regardless of their abilities.

Semantic HTML

Axiom's semantic-first approach provides a strong foundation for accessibility, making your content easier to understand for screen readers and other assistive technologies.

High Contrast

All default themes are designed with high-contrast color palettes to ensure readability for users with low vision.

Keyboard Navigation

All interactive components are fully navigable using a keyboard, ensuring that users who cannot use a mouse can still access all functionality.

Badges

Badges are a great way to highlight small pieces of information, suchs as counts or statuses.

Default Primary Secondary Success Warning Error Pill

Free and Open Source

Axiom01 is released under the MIT License, which means it's free for everyone, for any project. We believe in the power of open source to create better software for everyone. Whether you're building a personal blog, a corporate website, or a complex web application, you can use Axiom without any restrictions.

MIT License

Use Axiom in any project, commercial or personal. The code is yours to modify and distribute.

View License (MD)

Community Driven

Axiom is built by a community of developers. We welcome contributions of all kinds, from bug reports to new features.

Contributing Guide (MD)

AI-Ready Components

Axiom is one of the first UI frameworks to include AI-powered components out of the box. Integrate powerful AI features into your applications with just a few lines of code.

Media & Icons: Optimized for Performance and Flexibility

Axiom provides a robust approach to handling media assets and icons, ensuring your visuals are performant, responsive, and visually consistent. Our philosophy emphasizes flexibility, allowing you to choose the best format for your needs while maintaining high quality.

Images

From responsive images that adapt to any screen size to lazy loading for improved performance, Axiom helps you deliver stunning visuals without compromising speed. We encourage modern formats like WebP for optimal compression.

Icons & SVGs

Integrate scalable vector graphics (SVGs) and icon fonts seamlessly. Axiom provides guidance on using icons for accessibility and ensures they scale beautifully without loss of quality.

Icons and Graphics

Axiom supports both icon fonts and SVGs, giving you the flexibility to choose the best format for your project. We recommend using SVGs for their scalability and small file size, but we also provide full support for Font Awesome.

Icon Fonts

Use any icon font library, like Font Awesome, by including the library's CSS and using the appropriate classes.

SVGs

Embed SVGs directly into your HTML for maximum control over styling and animation.

Forms, Inputs, and Editors

Axiom provides a solid foundation for building accessible and user-friendly forms. Our components are designed to be flexible and can be easily combined to create complex data entry experiences.

Standard Inputs

Rich Text Editor

Axiom integrates seamlessly with third-party libraries like CKEditor to provide rich text editing capabilities.

The Grid: Simple, Powerful, and Responsive

Axiom's grid system is designed to be both simple and powerful, built on the flexibility of CSS Grid. It allows you to create complex, responsive layouts with minimal effort, adhering to modern responsive design patterns.

Mobile-First

Axiom is mobile-first, meaning components and layouts are designed for small screens first, then enhanced for larger screens.

Fluid & Responsive

The grid is fluid and responsive, adapting to any screen size without the need for utility classes.

Semantic

Create layouts with semantic HTML and minimal classes, making your code cleaner and more maintainable.

The Axiom Style: A Guide to Semantic Design

Axiom is more than a UI framework; it's a design philosophy. By following these principles, you can create interfaces that are not only beautiful and functional but also clean, maintainable, and accessible.

Structure with Semantics

Use the right HTML tag for the job. <nav> for navigation, <main> for the main content, <article> for self-contained content, etc. A well-structured document is the foundation of a great user experience.

Style with Classes, Not Utilities

Axiom components are styled with a single class. Avoid the temptation to add utility classes for minor tweaks. Instead, embrace the cascade and create new components or variations when needed.

Accessibility First

Design for everyone. Use proper headings, ARIA attributes, and color contrast. A semantic structure is the first step toward an accessible application.

Code in Action: The Axiom Advantage

Axiom is designed to be simple, semantic, and powerful. See how creating a complex component like a card in Axiom compares to a utility-first framework.

Axiom

Clean, semantic, and easy to read. The single .card class handles all the styling.

<article class="card">
    <header>
        <img src="img/axiom.jpeg" alt="Axiom Logo">
        <h3>Axiom Card</h3>
    </header>
    <main>
        <p>This is a simple card component.</p>
    </main>
    <footer>
        <button class="primary">Learn More</button>
    </footer>
</article>

Utility-First Framework

Verbose and hard to read. The styling is mixed directly into the HTML.

<div class="max-w-sm rounded overflow-hidden shadow-lg bg-white">
    <img class="w-full" src="img/axiom.jpeg" alt="Axiom Logo">
    <div class="px-6 py-4">
        <div class="font-bold text-xl mb-2">Card Title</div>
        <p class="text-gray-700 text-base">This is a simple card component.</p>
    </div>
    <div class="px-6 pt-4 pb-2">
        <span class="inline-block bg-gray-200 rounded-full px-3 py-1 text-sm font-semibold text-gray-700 mr-2 mb-2">#axiom</span>
    </div>
</div>

Why Choose Axiom?

Axiom is built on a different philosophy from other frameworks. We believe in clean, semantic HTML and a framework that gets out of your way. Here's how we compare to some of the most popular alternatives:

Feature Axiom Bootstrap Tailwind CSS
Semantic HTML Encouraged Discouraged Not Applicable
Class Usage Minimal Component-based Utility-first
Accessibility High High Developer-dependent
Customization High (via CSS Variables) Medium (via Sass) High (via config)

Proudly Powering

Axiom01 is already being used to build beautiful, semantic websites. Here are a few examples of live sites that are built with Axiom.

Version 1.0.1

Released on May 24, 2026

~12KB

CSS & JS

42+

Components

20+

Themes