Up and running in minutes

Overview

ASYNC is an Engineering Intelligence Platform that correlates data across your project management, source control, messaging, meetings, and documentation tools to surface actionable insights for engineering teams. It's built on Atlassian Forge, so all data stays within Atlassian's cloud infrastructure.

The setup process follows three sequential gates. ASYNC guides you through each one automatically. When you open the dashboard for the first time, it detects which gate you're at and shows the appropriate next steps.

Requirements

Before installing ASYNC, verify your environment meets these requirements:

Install from Atlassian Marketplace

1. Find ASYNC on the Marketplace

   Visit the ASYNC listing on the Atlassian Marketplace, or search for "ASYNC" in your Jira instance under Jira Settings → Find new apps.

2. Install to your site

   Click Get it free (for teams up to 10 users) or select your plan. Confirm the installation when prompted. The app is installed instantly via Atlassian Forge with no servers, no infrastructure, and no waiting.

3. Confirm the installation

   After installation, ASYNC appears in three locations within Jira:

   • Top navigation - The ASYNC dashboard (global page, accessible to all users)
   • Jira Settings → Apps → ASYNC - Administration console (site admins only)
   • Project Settings → Apps → ASYNC - Per-project configuration (project admins)

The ASYNC listing on the Atlassian Marketplace with the "Get it free" installation button.

Gate 1: Admin Setup

The first time any user opens the ASYNC dashboard, they'll see a "Welcome to ASYNC" screen if administration hasn't been configured yet. This is Gate 1, where ASYNC needs a site administrator to complete the initial organization-level setup.

Gate 1: Users see a welcome screen directing them to ASYNC Administration. Non-admins can copy a pre-written message to send to their site administrator.

What users see

When Gate 1 is active, the dashboard displays:

• A settings icon in a blue circle indicating setup is needed
• A "Go to ASYNC Administration" button that navigates directly to the admin console
• A "Copy Message" button that copies a pre-written request message to the clipboard, so non-admin users can ask their administrator to complete the setup

Complete the admin configuration

Click "Go to ASYNC Administration" to open the admin console (Jira Settings → Apps → ASYNC). The minimum configuration to pass Gate 1 is:

1. Set your organization name

   ASYNC auto-populates this from your Jira site. Review it and adjust if needed. This name appears in handoff notifications and reports.

2. Configure ASYNC availability

   Choose whether ASYNC is available to All projects or Specific projects (recommended). If you select specific projects, add at least one project to the list.

3. Connect integrations (optional but recommended)

   Switch to the Integrations tab and connect your source control, messaging, meetings, and documentation tools via OAuth. Each integration adds additional signal depth to ASYNC's intelligence. See the Administration Guide: OAuth Integrations for detailed steps.

4. Configure AI (optional)

   In the AI Configuration section, enable Atlassian Rovo (if available on your plan) and optionally configure an LLM provider for AI-Powered Insights. See the Administration Guide: AI Configuration for provider options.

5. Save changes

   Click Save changes at the top of the Settings tab to persist all configuration. Gate 1 is now complete.

Gate 2: Project Setup

After admin setup is complete, users see a "Configure a Project" screen if no projects have been configured with ASYNC yet. This is Gate 2, where at least one project needs team and integration settings before data can flow.

Gate 2: ASYNC lists up to 3 of the user's active projects with direct links to each project's ASYNC settings. Non-admins can copy a message for their project administrator.

What users see

When Gate 2 is active, the dashboard displays:

• A folder icon in a green circle indicating project setup is needed
• A list of up to 3 projects the current user is assigned to, each with a Settings button that navigates directly to that project's ASYNC configuration
• A "Copy Message for Project Admin" button for users who aren't project administrators
• If the user has more than 3 projects, a note directs them to contact their project administrators for the remaining ones

Configure the project

Click Settings next to a project to open its ASYNC configuration (Project Settings → Apps → ASYNC Settings). The minimum configuration to pass Gate 2 is:

1. Enable integrations for this project

   In the Integrations tab, toggle on the integrations you want to use for this project. Only integrations that have been connected at the organization level (in Admin Settings) are available here.

   For each enabled integration, select the specific resources to monitor:

   • Source control: Select repositories
   • Team messaging: Select channels
   • Meetings: Configure meeting filters
   • Documentation: Select spaces
2. Set up teams with timezones

   Switch to the Timezone & Teams tab and create at least one team. For each team, configure:

   • Team name - e.g., "Frontend", "Platform", "Mobile"
   • Timezone - Select from the dropdown or click "Use my timezone"
   • Working hours - Start and end times (default: 09:00 to 18:00)
   • EOD sync time - When the daily handoff sync runs (default: 18:00)
   • Team members - Search and add Jira users, assign roles and optional vendor

   See Project Settings for the full guide on team configuration.

3. Review sync settings

   The Sync Settings tab controls how often ASYNC pulls data. The default EOD (End of Day) mode syncs at each team's configured EOD time. Other options include every 15 minutes, hourly, or manual-only. Data retention is tier-dependent (14 days on Free, up to 90 days on Premium).

4. Save changes

   Click Save changes to persist the project configuration. Gate 2 is now complete for this project.

Gate 3: First Sync

Once both admin and project setup are complete, the dashboard shows a "Waiting for Data" screen. ASYNC is configured and the first sync needs to run before intelligence can be displayed.

Gate 3: ASYNC is configured and waiting for the first data sync to complete. Users can trigger an immediate sync or wait for the scheduled one.

What users see

When Gate 3 is active, the dashboard displays:

• A spinner icon in a yellow circle indicating sync is in progress or pending
• A message explaining that data usually appears within a few minutes
• A "Submit Handoff" button to trigger an immediate manual sync across all configured projects
• A "Refresh Page" button to check if data has arrived

Triggering the first sync

1. Click Submit Handoff

   This triggers an immediate sync for all your configured projects. ASYNC queues each project sequentially, pulling data from Jira and all connected integrations (source control, messaging, meetings, documentation).

2. Wait for sync to complete

   The first sync typically takes 1 to 3 minutes depending on your project size and number of integrations. A loading indicator shows while the sync is running.

3. Refresh the page

   Click Refresh Page once the sync completes. The dashboard will transition from the waiting state to the full Engineering Pulse view with your sprint context, metrics, and intelligence cards.

What's Next

Once the first sync completes, your ASYNC dashboard is live. Here's where to go from here: