skilld
All skills
sailscastshq avatar

/shipwright

@dbf6087
by The Sailscasts Companysailscastshq/boring-stack505 stars
25

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.

Ask your Agent

Use this Skill: https://skilld.dev/gh/sailscastshq/boring-stack/shipwright

This session only. Nothing lands on disk.

rulesgetting-started.md

≈611 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Getting started with Shipwright

Shipwright is the Sails asset hook built on Rsbuild. The templates use published sails-hook-shipwright ^1.5.1, which depends on @rsbuild/core ^2.2.5. Use Node ^20.19.0 || >=22.12.0 locally and in deployment.

Templates Framework plugin
Mellow React, Ascent React @rsbuild/plugin-react ^2.1.0
Mellow Vue, Ascent Vue @rsbuild/plugin-vue ^2.0.1
Mellow Svelte @rsbuild/plugin-svelte ^2.0.1

All five templates use Tailwind v4 with @rsbuild/plugin-tailwindcss ^2.0.3 and rsbuild-plugin-inertia for page discovery and optional SSR builds. Install dependencies with npm ci after scaffolding; keep the template lockfile committed.

Run npm run dev to lift Sails with frontend HMR. The template command watches api/ and config/ for backend restarts. Run npm start for production: Shipwright builds during Sails lift, then Sails serves the generated assets. Build dependencies must be available at this stage; do not omit devDependencies before a production lift that builds assets.

The Grunt hook stays disabled in .sailsrc. Configure builds in config/shipwright.js; do not add a second standalone build server.

Files and outputs

  • assets/js/app.js: browser entry; imports ~/css/app.css and starts Inertia.
  • assets/js/pages/: framework page components discovered by the Inertia build plugin.
  • assets/css/app.css: Tailwind import, theme, and application styles.
  • assets/js/ssr.js: optional server renderer entry.
  • views/app.ejs: Inertia root view using shipwright.styles() and shipwright.scripts().
  • .tmp/public/manifest.json: public asset manifest; use generated helpers rather than hardcoded hashed filenames.
  • .tmp/public/: browser JavaScript, CSS, images, fonts, and copied static assets.
  • .tmp/ssr/: private SSR entry and companion chunks, outside the public root.

Documentation lives at docs.sailscasts.com. Do not create a second documentation site in the repository's root docs/ directory.

Source: SKILL.md on GitHub

Third-party checks

1 alert17d4 checks · Risk SAFE
  • Gen Agent Trust Hub17d

    No security issues were detected. The skill provides legitimate documentation and rules for managing the Shipwright build system, covering asset compilation, framework plugins, and development workflows.

  • Socket17d

    No alerts

  • Snyk17d

    Risk: LOW · No issues

  • Runlayer7mo

    8/8 files flagged

Provenance

Signed by skilld at dbf6087. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 3 days ago.

Activeupdated 3 weeks ago

Capability

Other metadata
metadata
{
  "author": "sailscastshq",
  "version": "1.1.0",
  "tags": "shipwright, rsbuild, build, vite, assets, tailwind, ssr, hmr, boring-stack"
}

README badge

README badge for sailscastshq/boring-stack/shipwright