← Todos los crates de Fission

cargo-fission

The fission command for project setup, running, testing, packaging, sites, and releases
0.16.0 · linux · macos · windows
Ver paquetes publicados en crates.io
Repositorio del código

Fission command

This Cargo package installs the first-party fission command:
•
fission init
•
fission add-target
•
fission doctor
•
fission devices
•
fission run
•
fission build
•
fission test
•
fission logs
•
fission ...

Usage

Create a new app:
fission init my-app

Create a complete website without prompts:
fission init my-site --template website
fission add-target web --project-dir my-site

--template website selects the website source template. It creates astatic-site project with Rust home/about pages, reusable navigation/footer widgets, design tokens, translations, target wiring, source assets, andWEBSITE.md with the normal build, serve, test, package and publish paths. Use the existing add-target command to select additional targets. Adding webpreserves the shared source and enables its existing WASM entrypoint; Web uses hash routes so secondary routes survive direct visits and refresh on GitHub Pages. No backend or website is provisioned or deployed.--template website requires a new source directory; user instructions and other pre-existing files are preserved. Existing apps should use fission add-target.
Immediately read generated AGENTS.md and linked guidance after init. If the enclosing Git root has user instructions, read those and AGENTS.fission.md. Keep generated fission.toml and edit Rust source, never generated HTML.
Register an existing app or example without overwriting existing files:
fission init existing-app

When the directory already has source, docs, assets, or platform files, init preserves them. It derives the package name from Cargo.toml when possible, detects existing platforms/<target>/ folders, writes fission.toml, and creates only missing generated support files.
Create a new app against a local Fission checkout:
fission init my-app --local-path /path/to/fission

Add more platform targets:
fission add-target web ios android --project-dir my-app

Check local SDKs, emulators, browsers, and Rust targets:
fission doctor web ios android --project-dir my-app

List runnable devices and targets:
fission devices --project-dir my-app
fission devices --project-dir my-app --json

Run and attach to app output/logs:
fission run --project-dir my-app
fission run --project-dir my-app --target web
fission run --project-dir my-app --target web --features fixtures
fission run --project-dir my-app --target android --device emulator-5554
fission run --project-dir my-app --target ios --device <simulator-udid>

fission run attaches by default. Use --detach to start the app and return, then use fission logs to attach later where the platform supports it:
fission run --project-dir my-app --target web --detach
fission logs --project-dir my-app --target web --follow

Build or run smoke tests without launching the full attached workflow:
fission build --project-dir my-app --target web --release
fission build --project-dir my-app --target web --features fixtures
fission test --project-dir my-app --target web
fission test --project-dir my-app --target ios --headless

Current platform status

•
windows, macos, linux: scaffolded and runnable through fission run
•
ios: scaffolded by the CLI and runnable on the simulator through fission run --target ios
•
android: scaffolded by the CLI and runnable on a device or emulator through fission run --target android
•
web: scaffolded by the CLI and runnable in a browser through fission run --target web
The CLI writes platform state to fission.toml and creates platforms/<target>/README.md notes with the current prerequisites and next steps for each target. For iOS it also generates:
•
assets/app-icon.png seeded from Fission's docs/fission_logo.png
•
platforms/ios/Info.plist
•
platforms/ios/package-sim.sh
•
platforms/ios/run-sim.sh
•
platforms/ios/test-sim.sh
For Android it also generates:
•
platforms/android/AndroidManifest.xml
•
platforms/android/package-apk.sh
•
platforms/android/run-emulator.sh
•
platforms/android/test-emulator.sh
For Web it also generates:
•
platforms/web/index.html
•
platforms/web/bootstrap.mjs
•
platforms/web/build-wasm.sh
•
platforms/web/run-browser.sh
•
platforms/web/test-browser.sh
The generated iOS bundle, Android package, and browser host page all use assets/app-icon.png as the default app icon seed.
See also:
•
../../../docs/cli-and-targets.md
•
../../../docs/platform-smoke-tests.md