Step-by-Step Guide: Create Your Own Jira App Without Coding

Welcome to AI Apps Builder for Jira. This guide will walk you through creating your own Forge app in just a few minutes, without writing any code.

Before You Start

To deploy or redeploy an app created with AI Apps Builder, you must be a Jira site administrator for the target Jira site.

If you are not an admin, you have two options for how to continue:

• Create your own Jira site or use a Jira Sandbox.

• After generating the app, share the app link with a Jira administrator for deployment.

For step-by-step instructions on the second option, see How to Move Forge Apps Built with AI Apps Builder to Another Jira Site.

Step 1: Start a Chat with AI

1. After installing the AI Apps Builder, you can find the app in the Apps menu in the sidebar. Click AI Apps Builder to open it and start a new chat with AI. Or open the Web Version of AI Apps Builder in your browser.

2. You'll see a chat box ready for your prompt. Describe the app you want to build in plain language. AI Apps Builder understands your native language.

You can attach screenshots directly in the chat with AI. Instead of describing a design style, upload images and ask the AI to use them as visual references.

3. Or you can choose the Jira solution from the ready-to-use templates.

The catalog in AI Apps Builder currently covers three major Jira categories:

Want better results from AI Apps Builder? Learn how to write clearer, more effective prompts with proven techniques and practical examples in our guide: How to Write Effective AI Prompts: Best Practices and Practical Examples.

You can also get this guide in your app by clicking the link in the prompt box.

Step 2: AI generates your own app

1. Click the button ➡️ or press Enter to submit your app idea.

2. Create a name for your Forge app or save the suggested one, then click Save to continue.

3. AI generates the app for you.

Step 3: Deployment

1. When your app is ready, click Ready to deploy to start deployment.

3. Before deployment, check your app in the preview environment. In this step your app runs real UI, real layout, and real behavior.

4. If everything looks good, move to the next tab to start deployment

You have two deployment options: Manual and Automatic.

Manual deployment

To deploy or redeploy an app created with AI Apps Builder, you must be a Jira site administrator for the target Jira site.

If you are not an admin, you have two options for how to continue:

• Create your own Jira site or use a Jira Sandbox.

• After generating the app, share the app link with a Jira administrator for deployment.

For step-by-step instructions on the second option, see How to Move Forge Apps Built with AI Apps Builder to Another Jira Site.

If you are deploying your own app manually for the first time, prepare your environment. Read this guide: Deploying Jira Apps with AI Apps Builder Using the Forge Installer

Video tutorial on manual deployment:

If you have installed the Forge installer with Node.js, the Forge CLI, and all dependencies, follow these steps:

1. Choose your Operating System and download the ZIP file.

2. Run Forge installer

2. Enter your Atlassian account email (e.g., your-email@company.com). You can copy and paste.

3. Enter your Jira domain (e.g., yourcompany.atlassian.net). You can copy and paste.

4. Enter your API Token

During deployment, AI Apps Builder asks for an API token. The token is used only to authorize the installation of the generated Forge app to your specific Jira Cloud site.

The API token:

• Is used only for deployment

• Is not stored by AI Apps Builder

• Is not used to access Jira data

• Is not used at the app’s runtime

• Is not used for analytics or data collection

• Does not affect the app after deployment

Once deployment is complete, the app runs independently as a standard Forge app within your Jira environment. It does not rely on the API token in any way.

If the API token expires or is revoked, the deployed app will continue to function normally.

The token is simply a secure authentication mechanism required by Atlassian to authorize app deployment.

To create an API token, follow these steps:

• Click the link Generate an API token from Atlassian Account Settings

• This opens Atlassian Account Settings in a new tab

• Click Create API token

• Enter a label like "AI Apps Builder"

• Click Create

• Copy the generated token.

Your app, created with the AI Apps Builder, runs on Atlassian Forge within Atlassian's secure environment. Before deployment, you can review all the scopes your app uses.

If you don't know where your app appears, read the detailed guide: How to access the apps, widgets, and dashboards you’ve built with AI Apps Builder.

If you have any questions, feedback, or ideas, just contact SaaSJet Support or email us at support@saasjet.atlassian.net. We’re always happy to help.

On the deployment page in Automatic Deployment tab, you can see details about your app: its name, placement (where to find it), date, and status.

Automatic Deployment

To deploy or redeploy an app created with AI Apps Builder, you must be a Jira site administrator for the target Jira site.

If you are not an admin, you have two options for how to continue:

• Create your own Jira site or use a Jira Sandbox.

• After generating the app, share the app link with a Jira administrator for deployment.

For step-by-step instructions on the second option, see How to Move Forge Apps Built with AI Apps Builder to Another Jira Site.

1. On the deployment page, fill in all required fields

During deployment, AI Apps Builder asks for an API token. The token is used only to authorize the installation of the generated Forge app to your specific Jira Cloud site.

The API token:

• Is used only for deployment

• Is not stored by AI Apps Builder

• Is not used to access Jira data

• Is not used at the app’s runtime

• Is not used for analytics or data collection

• Does not affect the app after deployment

Once deployment is complete, the app runs independently as a standard Forge app within your Jira environment. It does not rely on the API token in any way.

If the API token expires or is revoked, the deployed app will continue to function normally.

The token is simply a secure authentication mechanism required by Atlassian to authorize app deployment.

To create an API token, follow these steps:

• Click the link Generate an API token from Atlassian Account Settings

• This opens Atlassian Account Settings in a new tab

• Click Create API token

• Enter a label like AI Apps Builder

• Click Create

• Copy the generated token.

2. Click Test Connection to verify everything works.

Your app, created with the AI Apps Builder, runs on Atlassian Forge within Atlassian's secure environment. Before deployment, you can review all the scopes your app uses.

You can also download a ZIP archive of the latest source code version.

3. Than Click Deploy to Jira Cloud.

4. Wait for the deployment information. Here you can see details about your app: its name, placement (where to find it), date, and status.

If you don't know where your app appears, read the detailed guide: How to access the apps, widgets, and dashboards you’ve built with AI Apps Builder.

If you have any questions, feedback, or ideas, just contact SaaSJet Support or email us at support@saasjet.atlassian.net. We’re always happy to help.

Step 4: Improvement

You can improve your app in three ways:

• Keep chatting with AI.

• Download the generated code and share it with a developer.

• Get dev help from our team.

Improvement by chatting with AI

1. Click the logo and open the AI Apps Builder sidebar.

2. Select the app to refine.

3. If you want to improve any previous version, choose the target one version.

4. When you are in the chat of the right version, describe changes or additions in the box.

5. After AI completes the changes, check updete in the preview.

6. To apply changes, enter the API token on the deployment page and click Test connection.

6. Then click Redeploy application.

Improvement by sharing with a developer

1. Click the logo and open the AI Apps Builder sidebar

2. Select the app to refine.

3. To get the source code of a previous version, select the target version.

4. Then enter the API token on the deployment page and click Test connection.

5. Download the ZIP file with the generated code.

Get Dev Help — Manual App Support

You can request help from our team. Our developers can:

• Review the generated code

• Fix issues from AI generation

• Improve functionality

• Add custom logic based on your requirements.

1. Click the Dev Help button.

2. Fill in the required fields. Explain what is not working. Describe what you want your app to do, explain the expected behavior and business logic so our team understands your use case and goals.

You can upload screenshots, examples, or any relevant files to help us better understand your request.

3. Submit your request. After submission:

• We create a support ticket

• Our developers review your app and start working on improvements

• We contact you if clarification is needed

• We collaborate with you during the process.

Our goal is to help you improve your app so it fully matches your requirements and works correctly in your Jira environment.