Start building with Atlassian

Welcome to developing apps with Atlassian. Apps are how developers integrate with and customize our products.

You can build apps to help your team, or sell solutions in the Atlassian Marketplace. This page describes how to plan and build apps with our development platforms, product APIs, and other resources.

Step 1: Choose a product

Atlassian makes products that help teams get stuff done. Each product has development frameworks, REST APIs, and other tools to help you create apps and solutions.

If you aren't sure which product you want to customize, take a look at our list of products to learn more about Jira, Confluence, Bitbucket, Jira Service Desk, and others.

Step 2: Pick a deployment option

Atlassian offers three deployment options for our products: cloud, server, or Data Center. Cloud products are hosted by Atlassian. Server and Data Center products are hosted by our customers.

Cloud apps use different frameworks from server and Data Center apps, so you can't run the same app across different platforms without some adjustments.

See Cloud, server, and Data Center for an in-depth comparison of building apps for the different deployment options. Note that some products, such as Trello and Status page, are only available on cloud, while others are only server.

Step 3: Get set up

Each product has a set of developer documentation, including basic platform information, getting started guides, and API reference materials.

• Try Getting started with Forge to set up your environment with a simple cloud app.
• Try Getting started with Connect for another cloud app setup.
• Check out the cloud or server and Data Center documentation for more on our APIs for each product.

Step 4: Build your app

Once your development environment is set up for the product and platform you're interested in, it's time to start building. If you're extending the UI, see our design guidelines and frontend components.

• Cloud design guidelines
• Server and Data Center design guidelines
• UI components from Atlaskit

Step 5: Manage and share your apps (optional)

You can manage your Forge and OAuth 2.0 (3LO) apps in the developer console.

There are currently a number of ways to share your apps:

1. To share your app with your own team, you can install it on your team's Atlassian site.
2. To share your app with specific users, you can distribute your app via the developer console. This lets users install your app on their own Atlassian sites, and is useful for internal use, or to test your apps.
3. To share your app with Atlassian's global customer base, you can list your app in the Atlassian Marketplace. You can make money by selling your app, or list the app for free. We're also working on making it possible to list Forge apps.

Get help and support

If you can't find the answers to your questions in our documentation, you can leave feedback on the pages you use.

See Help and feedback for a full list of resources available to developers, like the developer community, Marketplace support, status page, and more.