Create Your First App - Step-by-Step Guide

Welcome to the Forge Apps Generator! This guide will walk you through creating your custom Jira app in just a few minutes.

Step 1: Start a New Chat

1. Click "Start New Chat" in the main interface

2. You'll see a chat box ready for your input

3. 

Step 2: Describe Your App Idea

Type a clear description of what you want your app to do.

Before describing your idea, decide what type you want to create:

🔧 Forge App (Full Application)

• Appears in Jira sidebar, project pages, or issue panels

• Complete custom functionality and user interface

• Full access to Jira APIs and data

• Best for: Complex workflows, custom pages, detailed task management

📊 Dashboard Gadget (Widget)

• Appears on Jira dashboards as a widget

• Focused on data visualization and reporting

• Perfect for charts, metrics, and summaries

• Best for: KPIs, progress tracking, team metrics, visual reports

Step 3: Send Your Request

Click "Send" or press Enter to submit your app idea.

Step 4: Connect to Your Jira Instance

Before you can deploy apps, you need to connect the generator to your Jira:

1. The setting tab will be automatically opened (gear icon) in the interface

2. Fill in the connection details:

   

📧 Email Address

• Enter your Atlassian account email (e.g., your-email@company.com)

🌐 Atlassian Domain

• Enter your Jira domain without https:// (e.g., yourcompany for yourcompany.atlassian.net)

🔑 API Token

• 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 "Forge Apps Generator"

• Click "Create"

• Copy the generated token

• Paste it into the API Token field in the generator

3. Click "Test Connection" to verify everything works

4. When you see "✅ Connection Successful", click “Save” button to Save your connection.

Step 5: Wait for Generation

The AI will analyze your request and generate:

• Complete app code

• User interface components

• Jira integration setup

• Configuration files

Step 5: Deploy Your App

When generation is complete:

1. Click "Deploy"

2. Wait for the "✓ Deployment Complete" message

3. Click "View in Jira" to see your new app

💡 Writing Great App Descriptions

Be Specific About What You Want

❌ Too Vague:

"Make a project tracking app"

✅ Just Right:

"Create a project page that shows sprint progress with burndown charts, lists overdue tasks, and displays team member workload"

📝 Example: Creating a Team Dashboard

Let's create a complete app together:

Your Input:

"Create a team dashboard that shows:

• Each team member's assigned tasks as progress bars

• Color-coded by priority (red=high, yellow=medium, green=low)

• Display on project pages in the sidebar

• Include a filter to show only current sprint tasks

• Show total story points per person"

What You'll Get:

• ✅ Interactive dashboard with team member cards

• ✅ Color-coded progress bars based on priority

• ✅ Story points calculation and display

• ✅ Sprint filter functionality

• ✅ Automatic deployment to your project sidebar