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.

With AI Apps Builder, you can use AI to generate custom apps, dashboards, issue panels, and reports that match your workflow

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 can:

• Use your own Jira site or a Jira Sandbox to generate and validate your 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 installation, you can find AI Apps Builder in your Jira site under the Apps menu in the sidebar. Click AI Apps Builder to open it and start a 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 English.

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:

Step 2: Describe Your App Idea

Start by typing a clear description of what you want your app to do. The more specific your description is, the better AI Apps Builder can generate the right Forge app for Jira.

Before writing your prompt, decide what type of app you want to create:

🔧 Full Application

A full Forge app for Jira with custom logic and UI that appears in the Jira sidebar or pages.
Best for: complex workflows, internal tools, custom pages, or process management.

📊 Dashboard Gadget

A lightweight dashboard widget focused on reporting and visualization that appears on Jira dashboards. Best for: KPIs, sprint progress, team metrics, SLA summaries, and visual reports.

🧩 Issue Panel

A contextual UI element displayed inside a Jira issue. Best for: sprint progress, overdue subtasks, SLA status, related issues, or custom issue-level metrics.

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 3: AI generates your own app

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

Choose a name for your Forge app. Save the suggested name or edit it if needed, then click Save to continue.

AI generates an app for you.

Step 4: Deployment

Click “Ready to deploy” to start deployment.

You have two deployment options: Manual and Automatic.

Manual deployment

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 have any questions, feedback, or ideas, just contact SaaSJet Support or email us at support@saasjet.atlassian.net. We’re always happy to help.

Automatic Deployment

1. 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.

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 download a ZIP archive of the latest source code version.

3. 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 5: Improvement

You can improve your app in two 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. 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.

Haven't used AI Apps Builder yet? You're welcome to try it then!

Have questions or want to see AI Apps Builder in action?
Feel free to meet with us — book a demo today!