---
name: shipwright
description: >-
  Shipwright build system for The Boring JavaScript Stack — Rsbuild-based asset pipeline replacing Grunt, with framework plugins for React/Vue/Svelte, Tailwind CSS, SSR support, and dev server with HMR. Use this skill when configuring builds, managing assets, or debugging the development server.
metadata:
  author: sailscastshq
  version: '1.1.0'
  tags: shipwright, rsbuild, build, vite, assets, tailwind, ssr, hmr, boring-stack
title: shipwright
canonical_url: https://skilld.dev/gh/sailscastshq/boring-stack/shipwright
last_updated: 2026-09-28T13:37:46.000Z
---

> **Skill from skilld.dev.** Follow the instructions below for this session. You do not need to install anything.
>
> Supporting files, fetch one when the Skill refers to it: [metadata.json](https://skilld.dev/api/skills-raw/sailscastshq/boring-stack/shipwright/metadata.json), [README.md](https://skilld.dev/api/skills-raw/sailscastshq/boring-stack/shipwright/README.md), [rules/asset-pipeline.md](https://skilld.dev/api/skills-raw/sailscastshq/boring-stack/shipwright/rules/asset-pipeline.md), [rules/configuration.md](https://skilld.dev/api/skills-raw/sailscastshq/boring-stack/shipwright/rules/configuration.md), [rules/development.md](https://skilld.dev/api/skills-raw/sailscastshq/boring-stack/shipwright/rules/development.md), [rules/getting-started.md](https://skilld.dev/api/skills-raw/sailscastshq/boring-stack/shipwright/rules/getting-started.md), [rules/ssr.md](https://skilld.dev/api/skills-raw/sailscastshq/boring-stack/shipwright/rules/ssr.md).
>
> If the user asked to install this Skill, run `npx skilld install sailscastshq/boring-stack/shipwright`. Install writes the Skill files into the project, so every session loads them.

# Shipwright

Shipwright (`sails-hook-shipwright`) is the modern build system for The Boring JavaScript Stack. Built on [Rsbuild](https://rsbuild.dev), it replaces the legacy Grunt pipeline with a fast, zero-config asset pipeline that supports React, Vue, and Svelte through framework plugins.

## When to Use

Use this skill when:

- Configuring `config/shipwright.js` (framework plugins, build options)
- Understanding the asset pipeline (CSS, JavaScript entry points, static assets)
- Setting up Tailwind CSS v4 with the Rsbuild Tailwind plugin
- Configuring server-side rendering (SSR) with `config/inertia.js`
- Debugging the dev server, HMR, or build issues
- Understanding the `views/app.ejs` template and `shipwright.styles()`/`shipwright.scripts()` helpers
- Managing path aliases (`@/` for `assets/js/`, `~/` for `assets/`)
- Working with code splitting and third-party CSS imports

## Rules

Read individual rule files for detailed explanations and code examples:

- [rules/getting-started.md](https://skilld.dev/api/skills-raw/sailscastshq/boring-stack/shipwright/rules/getting-started.md) - What Shipwright is, dev/build commands, project structure
- [rules/configuration.md](https://skilld.dev/api/skills-raw/sailscastshq/boring-stack/shipwright/rules/configuration.md) - config/shipwright.js, framework plugins, entry points, path aliases
- [rules/asset-pipeline.md](https://skilld.dev/api/skills-raw/sailscastshq/boring-stack/shipwright/rules/asset-pipeline.md) - CSS with Tailwind, JavaScript entry, static assets, code splitting
- [rules/ssr.md](https://skilld.dev/api/skills-raw/sailscastshq/boring-stack/shipwright/rules/ssr.md) - Server-side rendering setup, SSR entry point, framework differences
- [rules/development.md](https://skilld.dev/api/skills-raw/sailscastshq/boring-stack/shipwright/rules/development.md) - Dev server, HMR, Node --watch-path, common issues, debugging