Sailwind

A React component library for vibe coding that speaks Appian SAIL

Overview

Sailwind provides React components that mirror Appian SAIL parameter names and conventions. Components use exact SAIL syntax (size="STANDARD", color="ACCENT") so prototype code translates almost directly to production SAIL.

Built on Radix UI primitives, Tailwind CSS, and TypeScript.

For Prototypers

Use the sailwind-starter template to start building prototypes. It comes pre-configured with Sailwind and is ready for LLM-assisted development (Kiro, Cursor, Claude Code, etc.).

Browse the Component Reference to see what's available.

Installation

npm install @pglevy/sailwind

Peer Dependencies

Sailwind requires React 18 or 19 as a peer dependency:

npm install react react-dom

Supported versions:

• react — ^18.0.0 || ^19.0.0
• react-dom — ^18.0.0 || ^19.0.0

These are listed as peerDependencies in the package, so your project needs to provide them.

Setup

Import the CSS in your main entry file (e.g., main.tsx or App.tsx):

import '@pglevy/sailwind/index.css'

Using Images

If your components need the included icons, reference them like this:

import iconApp from '@pglevy/sailwind/images/icon-app.svg'
import iconInterface from '@pglevy/sailwind/images/icon-interface.svg'

<img src={iconApp} alt="App icon" />

Available images:

• icon-app.svg
• icon-appian-header.png
• icon-expression-rule.svg
• icon-interface.svg
• icon-record-type.svg

For Contributors

Setup

git clone https://github.com/pglevy/sailwind.git
cd sailwind
npm install

Development

Storybook is the primary development environment:

npm run storybook     # Start Storybook at http://localhost:6006

Every component has a .stories.tsx file for documentation and interactive testing. When adding or modifying components, update the corresponding stories.

Build

npm run build:lib         # Build the npm package (dist/)
npm run build-storybook   # Build the Storybook site (storybook-static/)
npm run lint              # Run ESLint

Project Structure

src/
├── components/         # SAIL components (Button, Card, Dropdown, etc.)
│   └── */              # Each component has its own directory with stories
├── stories/
│   ├── pages/          # Full page examples (realistic Appian interfaces)
│   └── patterns/       # Common UI patterns (forms, grids, data displays)
├── types/              # Shared TypeScript types (SAILSize, SAILAlign, etc.)
└── index.css           # Tailwind v4 theme configuration

Publishing to npm

npm run build:lib
npm publish --access public

See PUBLISHING.md for detailed release instructions.

Component Comparison

React (Sailwind):

<TagField
  size="STANDARD"
  tags={[
    { text: "URGENT", backgroundColor: "#FED7DE", textColor: "#9F0019" }
  ]}
/>

SAIL (Production):

a!tagField(
  size: "STANDARD",
  tags: {
    a!tagItem(text: "URGENT", backgroundColor: "#FED7DE", textColor: "#9F0019")
  }
)

Documentation

• Component Reference — Live Storybook with all components
• TAILWIND-SAIL-MAPPING.md — Tailwind to SAIL style mappings
• CONTRIBUTING.md — How to contribute to the project
• AGENTS.md — Guidance for AI agents working with the library
• SAIL Docs — Official Appian SAIL reference

License

MIT