Get Started

In order to start building Fig apps, you'll need to download Fig.
1.Currently, Fig is a limited beta. To sign up for the developer preview, please fill out this form and join our developer community. We're really excited to see what you build. :)

2.Once you have Fig, you'll need to create the project structure for your Fig app.
Luckily, this is very simple. The minimal project requires no dependencies (besides fig.js which is included automatically at runtime) and no build process.
sample.html
1
<html>
2
  <head>
3
    <meta fig:app = "sample-app">
4
    <script>
5
      fig.init = (stdin, options) => {
6
        // fig.init is the entry point to your app's logic.
7
        // Calling any fig command prior will result in undefined behavior. 
8
        
9
        fig.title = fig.env.PWD
10
        fig.icon = `fig://${fig.env.PWD}`
11
        
12
        fig.execute('ls -1', (files) => {
13
          document.body.innerText = files
14
        })
15
      }
16
    </script>
17
  </head>
18
  <body>
19
​
20
  </body>
21
</html>
Copied!
fig local sample.html
1.Debugging your app.
You can open the Safari Web Inspector by right clicking on your app. The Fig API is still maturing, so if you run into unexpected behavior, please let me know at [email protected] or in the #bugs channels of the Slack community.

2.Running your app
fig local path/to/app.html  

While testing, it can be useful to add this snippet to your sidebar for quick access. 
1.Run fig home 
2.Press "Add Code Snippet" button
3.Choose an emoji and a name
4.Add fig local path/to/app.html
​
3.(Advanced) Adding apps to your $FIGPATH
If you want to access your Fig apps without typing out the full path, you can add them to your FIGPATH - a colon separated list of paths where Fig will check for a matching app.

For instance, if you run fig sample-app , Fig will check every directory added to your FIGPATH for...
1.sample-app.html
2.sample-app/index.html

You can update your FIGPATH by adding something likeexport FIGPATH=/User/mschrage/path/to/apps to your .profile .

Build your own App

App Lifecycle

Last modified 1yr ago

Copy link