sails-new-app
Installation
SKILL.md
Sails New App
Goal
Move a greenfield request from scope to an approved Sails workspace path without skipping the planning artifacts that later implementation depends on.
Sequence
- If the machine does not already have
rustup, the required Wasm targets,cargo-sails, and a localgearbinary, start with../sails-dev-env/SKILL.md. - For a new standard Sails/Vara project, bootstrap the workspace first with
cargo sails new <project-name>unless the user explicitly needs a custom non-template layout. - Write the feature or app goal to
docs/plans/YYYY-MM-DD-<topic>-spec.mdusing../../assets/spec-template.md. - Route architecture decisions through
../sails-architecture/SKILL.md. - Keep the standard template workspace shape created by
cargo sails new <project-name>intact:app,client,src,tests, top-levelbuild.rs, Wasm output, and generated-client path. - Keep the standard build-script pipeline intact. In a standard Sails workspace, use the repo-generated build path for
.idland Rust client artifacts. For a dedicated client crate, prefersails-rswithfeatures = ["build"]andsails_rs::build_client::<Program>()before introducing manualsails-idl-gen/sails-client-genwiring. - Validate before moving to later phases by finishing with
../sails-gtest/SKILL.md, then../sails-local-smoke/SKILL.md. - When the builder needs a frontend, use
create-vara-appto scaffold it from the program's.idl:npx create-vara-app <name> --idl path/to/service.idl. Then route to../sails-frontend/SKILL.mdfor customization.