Rate this page:
This tutorial walks through creating a Forge app to display content on a Confluence page.
Complete Getting started before working through this page.
Create an app based on the Confluence macro template.
Note, Forge provides multiple environments where you deploy the app. This tutorial uses the CLI default, the environment. See Environments to learn more.
Note, the CLI uses keychain to securely store your login details. If you see a prompt for keychain access when running a command, approve it to allow the CLI to run the command.
Create your app by running:
The confluence-macro template uses Node.js and has the following structure:
1 2 3 4 5 6 7
hello-world-app |-- src | `-- index.jsx |-- manifest.yml |-- package.json |-- package-lock.json `-- README.md
Let’s have a look at what these files are:
This app displays content within a Confluence page using a . Confluence shows the title of the macro in the quick insert menu when you add the app to a page. Let's change the title to include your name.
Your file should look like the following, with your values for the title and app ID.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
permissions: scopes: - 'read:confluence-content.summary' modules: macro: - key: hello-world-app-hello-world function: main title: Forge app for Mia description: Inserts hello world! function: - key: main handler: index.run app: id: '<your app id>' name: hello-world-app
Any time you make changes to the code, deploy your app using the command. This command builds your code and reports any compilation errors.
To install your app on a new site, run the command. Once the app is installed on a site, it will automatically pick up all minor app deployments, which means you don't need to run the install command again. A minor deployment includes any change that doesn't modify app permissions in the manifest.
In the Forge environment, your app is deployed with all available OAuth scopes. Later in this tutorial, you’ll learn how to restrict your app to request just the access it needs.
Navigate to the app's top-level directory and deploy your app by running:
Install your app by running:
Select your Atlassian product using the arrow keys and press the enter key.
Note: Running command installs your app in all available Atlassian products on the site. You don’t need to run the command for each product.
Enter the URL for your development site. For example, example.atlassian.net.
Note, you need to run before running in any of the Forge environments.
With your app installed, it’s time to see the app on a page.
Your hello world app is now installed into your development site. The app should display on the page like the image below.
Note, while your app is deployed to either a development or staging environment, or will appear in your app title. This suffix is removed once you've deployed your app to production.
See Part 2: Call a Confluence API to learn how to call a product API from your app.
Rate this page: