Guidelines/Getting Started

Getting Started

Download the source · prompt an AI agent · ship a new project on SLAB

1Download the source

SLAB isn't an npm package — it's a source tree (tokens/, components/, styles.css) that's the single source of truth. Clone or copy it as a sibling folder to your new project, not inside it:

my-workspace/ slab/ ← the design system source my-new-app/ ← your new project
2Give the AI context first

Copy slab/SKILL.md into my-new-app/CLAUDE.md (or .cursorrules / your tool's equivalent). This hands the agent the neo-brutalist rules — borders, hard shadows, type, motion — so you don't have to restate them every prompt.

3Prompt the AI to bootstrap the project

One prompt is enough — the agent can read SKILL.md, styles.css, and components/ itself:

# Prompt Set up this Next.js project to use the SLAB design system located at ../slab. Add a @slab/* path alias pointing there, import slab/styles.css once in the root layout, and confirm you can render the Button and Card components from slab/components. Follow the rules in CLAUDE.md for anything new you build — thick ink borders, hard offset shadows, no gradients or blur.
4Check what the AI actually did
  • Added "@slab/*": ["../slab/*"] to tsconfig.json paths
  • Imported @slab/styles.css exactly once, in the root layout/entry file
  • Imports components as import { Button } from "@slab/components/core/Button"
  • Left slab/ itself untouched — no edits to tokens or components
5Steer it toward the visual language

Tell it to skim slab/guidelines/components.html and a relevant slab/ui_kits/ example before generating new screens. Left alone, AI tools default to soft shadows and rounded minimalism that fights the SLAB aesthetic.

✓CLAUDE.md before codePaste the SKILL.md rules before the agent generates a single component.
✓One global importOnly styles.css needs importing — never re-import individual token files.
✕Don't let it edit slab/Treat the source folder as read-only from the new project's side.
✕Don't skip the reviewDiff the path alias and global import — duplicated token imports are the most common AI slip.