Working with Apps

Use the fission app command and its subcommands to work with apps. The main operations are registering an app, publishing an app, and displaying information about an app.
Register an app
The fission app register command initializes a new app and links it to your Fission account.
1
$ fission app register
2
👷 Build directory (.): 
3
✅ App initialized as big-narrow-fuchsia-elf.fission.app
4
⏯️  Next run fission app publish or fission app publish --watch to sync data
5
💁 It may take DNS time to propagate this initial setup globally. In this case, 
6
you can always view your app at 
7
https://ipfs.runfission.com/ipns/big-narrow-fuchsia-elf.fission.app
Copied!
You will be prompted for a build directory. The Fission CLI will publish your app from the build directory you select. 
If you are using a common build directory, the Fission CLI will detect it when you run fission app register and suggest it. You accept the suggestion or enter another build directory as a relative path from the fission.yaml file.
The Fission CLI will create a fission.yaml configuration file with a list of files to ignore, a URL where your app will be viewable after it is published, and a build directory. See the Fission YAML guide for more information about the fission.yaml file.
You can also use a custom domain name for your app. See the Custom Domains guide to set up a custom domain name.
The fission app register command has advanced options:
1
$ fission app register --help
2
Usage: fission app register [--ipfs-bin BIN_PATH] [--ipfs-timeout SECONDS] 
3
                            [-v|--verbose] [-a|--app-dir PATH] 
4
                            [-b|--build-dir PATH] [-n|--name NAME]
5
  Initialize an existing app
6
​
7
Available options:
8
  --ipfs-bin BIN_PATH      Path to IPFS binary (default: `which ipfs`)
9
  --ipfs-timeout SECONDS   IPFS timeout (default: 300)
10
  -v,--verbose             Detailed output
11
  -a,--app-dir PATH        The file path to initialize the app in (app config,
12
                           etc) (default: ".")
13
  -b,--build-dir PATH      The file path of the assets or directory to sync
14
  -n,--name NAME           Optional app name
15
  -h,--help                Show this help text
Copied!
Publish an app
Use the fission app publish command to publish your app to the web. Run this command from the directory that contains your app's fission.yaml configuration file.
The fission app publish command publishes your app and associates it with the URL in the fission.yaml file. After your app is published, the Fission CLI will output a success message and the URL for your app.
1
$ fission app publish
2
🕚🛫 App publish local preflight
3
✈️  Pushing to remote
4
🚀 Now live on the network
5
📝 DNS updated! Check out your site at:
6
🔗 big-narrow-fuchsia-elf.fission.app
Copied!
The fission up command is a shortcut for fission app publish.
The fission app publish command has advanced options:
1
$ fission app publish --help
2
Usage: fission app publish [--ipfs-bin BIN_PATH] [--ipfs-timeout SECONDS] 
3
                           [-v|--verbose] [--update-data ARG] [--update-dns ARG]
4
                           [-w|--watch] [PATH]
5
  Upload the working directory
6
​
7
Available options:
8
  --ipfs-bin BIN_PATH      Path to IPFS binary (default: `which ipfs`)
9
  --ipfs-timeout SECONDS   IPFS timeout (default: 300)
10
  -v,--verbose             Detailed output
11
  --update-data ARG        Upload the data (default: True)
12
  --update-dns ARG         Update DNS (default: True)
13
  -w,--watch               Watch for changes & automatically trigger upload
14
  PATH                     The file path of the assets or directory to
15
                           sync (default: "./")
16
  -h,--help                Show this help text
Copied!
Continuously Update an App with Watch
You can continuously publish your app by adding the --watch option. The Fission CLI will watch your build directory and publish whenever it detects a change.
1
$ fission app publish --watch
2
🕚🛫 App publish local preflight
3
✈️  Pushing to remote
4
🚀 Now live on the network
5
📝 DNS updated! Check out your site at: 
6
🔗 big-narrow-fuchsia-elf.fission.app
Copied!
This means that as you work in your local development environment, changes are continuously streamed online as you save. Note that some development environments have different code and output options than "production", but this will allow you to quickly and easily share a live online version with other people. 
Display information about an app
Use fission app info to display the URL where your app is viewable.
1
$ fission app info
2
✅ App available at big-narrow-fuchsia-elf.fission.app
Copied!
​
​

Managing Your Account

Fission YAML

Last modified 3mo ago

Export as PDF

Copy link

Contents

Publish an app

Continuously Update an App with Watch

Display information about an app

Register an app

Publish an app

Continuously Update an App with Watch

Display information about an app

​