Getting Started with ANTSAND Styles

A standalone CSS library with 920 classes — optimized to work with the ANTSAND Databoard compiler, where every deployed site ships with these styles by default.

Build with ANTSAND Styles

A practical reference for the CSS framework, Databoard contracts, template system, utilities, and AI-readable workflows behind generated ANTSAND sites.

Documentation

Three Ways to Use

ANTSAND Styles works at every level: a standalone CSS library, a headless Databoard backend, or the full generated-site compiler.

Three Ways to Use

Standalone CSS

Drop one CSS file into any HTML project. No ANTSAND backend, no build tools, no generated app required.

  • CDN or local include
  • Reusable components and utilities
  • Themes, fonts, responsive defaults
  • Works with React, Vue, PHP, or plain HTML
Best for static sites, prototypes, and non-ANTSAND projects.

Headless + Databoard

Use your own frontend while ANTSAND Databoard manages structured content, reusable data, and API-driven updates.

  • Your framework, routing, and hosting
  • Databoard owns content and data sources
  • Styles load through the shared CSS contract
  • AI can patch data, classes, and Sass through APIs
Best for custom apps that want ANTSAND as the control plane.

Full Compiler

Let ANTSAND generate the HMVC website. Pages, routes, ACL, data mappings, Sass, and deploys stay connected.

  • Header / Body / Footer sections become real pages
  • Field classes compile into deployable CSS
  • Routes, forms, ACL, notes, and ecommerce stitch together
  • Inspect, patch, compile, deploy, smoke test, repeat
Default path for ANTSAND-deployed production sites.

Same content contract, different surface.

These cards are structured data mapped into HTML-shaped fields, then styled by Sass v2 plus board-level Sass.

Data contract: h3 + p + ul + small

Already using ANTSAND?

If Databoard compiles your site, antsand-v2.css is already in every page's . If you use ANTSAND as a headless CMS with your own frontend, include the library via CDN so your app shares the same design system.

Standalone & Headless Quick Start

For standalone projects or custom frontends, include one CSS file and start with semantic ANTSAND classes. Full installation examples belong in the deeper docs pages.

1. Include the CSS

HTML <head> html
<link rel="stylesheet" href="https://styles.antsand.com/css/antsand-v2/antsand.css">

2. Use semantic classes

Start with component identity, then add utilities only where the field needs local layout or polish.

component example html
<button class="antsand-btn antsand-btn-primary">Start</button>

<div class="antsand-card antsand-card-shadow p-6">
  <h3 class="antsand-card-title">Feature card</h3>
  <p class="antsand-card-text">Semantic shell, utility polish.</p>
</div>

ANTSAND Databoard Integration

When you deploy a site through ANTSAND, the styles library is already in the rendered HTML. You style by assigning CSS class names to Databoard fields:

CSS class assignment via API or control panel

databoard — CSS class assignments via API or control panel json
{
  "section.container": "antsand-section theme-dark-editorial",
  "data.container": "antsand-grid md-grid-cols-3 gap-6",
  "data.sub_container": "antsand-card shadow-md transition-all hover-translate-y-1",
  "data.h3": "line-clamp-3 font-semibold md-text-xl",
  "data.p": "line-clamp-3 opacity-70",
  "data.cta": "antsand-btn antsand-btn-primary antsand-btn-sm"
}

How it works: The ANTSAND compiler reads a Databoard JSON object containing your content + CSS class assignments. It resolves Volt templates, applies the Header/Body/Footer section contract, compiles Sass, and deploys a production site. The antsand-v2.css stylesheet is auto-included — no manual linking needed.

AI agents use a REST API to style ANTSAND sites programmatically:

Agent top-level bash
# 1. Inspect current state
curl -X GET /api/v1/databoards/$BOARD_ID -H "Authorization: Bearer TOKEN"

# 2. Patch CSS classes on fields
curl -X POST /api/v1/databoards/$BOARD_ID/patch \
  -H "Authorization: Bearer TOKEN" \
  -d '{ "patch_delta": { "datalist.0.css.section.container": "antsand-section theme-dark-corporate" } }'

# 3. Compile utilities (generates only used CSS)
curl -X POST /api/v1/utilities/compile -H "Authorization: Bearer TOKEN"

# 4. Deploy
curl -X POST /api/v1/databoards/$BOARD_ID/deploy -H "Authorization: Bearer TOKEN"

Two-Tier Class System

Use semantic Sass v2 classes for component identity, then add utility classes for spacing, layout, sizing, and small page-specific adjustments.

Two-tier styling

Tier 1: Semantic Components

Named by role. These classes define what the element is and keep repeated patterns consistent.

  • antsand-btn antsand-btn-primary
  • antsand-card
  • antsand-section
  • antsand-grid
  • antsand-topnav
  • antsand-footer
Use these first for buttons, cards, nav, forms, sections, and reusable UI.

Tier 2: Utility Classes

Property-driven helpers that tune the semantic structure without rewriting the component.

  • md:grid-cols-3 gap-6
  • shadow-md hover:-translate-y-1
  • line-clamp-3 opacity-75
  • px-4 py-2 rounded-lg
  • font-semibold md:text-xl
Use these after the semantic class when a field needs local layout or polish.

Buttons are always antsand-btn, never only px-4 py-2 bg-blue. Already using ANTSAND? If Databoard compiles your site, antsand-v2.css is already in every page's head. If you use ANTSAND as a headless CMS with your own frontend, include the CDN so your app shares the same design system.

Rule

For AI Agents

Copy the getting-started prompt to give your AI agent full context on using ANTSAND Styles — both standalone and with the Databoard compiler.

Explore the Framework

Components

Buttons, cards, forms, modals, tabs, alerts, toasts — all types.

🧩

Utilities

Spacing, colors, typography, layout, visibility, animations.

⚙️

Font Library

40+ self-hosted fonts with weights, pairings, and samples.

🔤

CSS Specificity

No !important — proper cascade and layer management.

🎯

API Reference

REST endpoints for inspect, patch, compile, deploy.

��

Agent Quick Start

Step-by-step guide for AI agents to style ANTSAND sites.

🤖

Blog Guide

Create beautiful blog posts and article layouts.

📝

Themes

4 built-in themes — one class activates an entire look.

🎨