Frameworks

Hiraiship looks at your project, recognizes its framework, and picks the build command and output to match. You don't declare anything.

Framework	Detected by	Build command	Output	Runs as
Rasengan.js	rasengan dependency, or rasengan.config.js/.ts	npx rasengan build	dist/client	Static files, or a Worker when server-rendered
Hono	hono dependency	npm run build --if-present	One bundled Worker	A Worker
Futon	@rasenganjs/futon dependency	npm run build --if-present	One bundled Worker	A Worker
Vite	vite dependency and a vite build script or a vite.config.* file	npx vite build	dist	Static files
Static	No package.json	None	The directory itself	Static files

Detection order

Detection reads package.json (dependencies and devDependencies) at the root of what you deploy, and checks the order above. For an app in a subdirectory of a GitHub monorepo, the repository root's package.json dependencies count too, when the app's own name none: shared tooling such as vite often lives there.

1. Rasengan.js first, since a Rasengan.js app also depends on Vite.
2. Hono or Futon. A project depending on both is ambiguous and fails with an error: deploy them as two projects.
3. Vite, when the build script runs vite build or a vite.config.* file exists.
4. Otherwise, a directory without a package.json is deployed as a static site. One with a package.json fails with an error naming the supported frameworks: publishing it as it is would publish your source.

The detected framework is shown on each deployment.

Install command

Before building, Hiraiship installs your dependencies with the package manager your lockfile names:

A static site skips the install.

Changing the defaults

The install command, build command and output directory can each be replaced, for every deployment of a project or for a single one. See Build settings.

Not supported yet

• Next.js is planned.
• Monorepos: Hiraiship builds the directory you deploy. Deploy the app's own directory, with its own lockfile.
• Other backends (Express, Fastify, NestJS): they need a Node.js server, which Workers don't provide.