You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: flagsmith-jira-app/README.md
+31-14Lines changed: 31 additions & 14 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,9 +1,12 @@
1
1
# Flagsmith Jira App
2
2
3
-
This project contains a Forge app written in TypeScript that provides a table of Flagsmith features in a Jira issue panel.
4
-
The app is based on the [Jira hello world app](https://developer.atlassian.com/platform/forge/build-a-hello-world-app-in-jira/) so any oddities in its configuration are as created by following those instructions.
3
+
This project contains a Forge app written in TypeScript that provides a table of Flagsmith features in a Jira issue
4
+
panel. The app is based on the
5
+
[Jira hello world app](https://developer.atlassian.com/platform/forge/build-a-hello-world-app-in-jira/) so any oddities
6
+
in its configuration are as created by following those instructions.
5
7
6
-
See [developer.atlassian.com/platform/forge](https://developer.atlassian.com/platform/forge) for documentation and tutorials explaining Forge.
8
+
See [developer.atlassian.com/platform/forge](https://developer.atlassian.com/platform/forge) for documentation and
9
+
tutorials explaining Forge.
7
10
8
11
## Overview
9
12
@@ -23,21 +26,25 @@ See [README.md](../README.md) in the containing folder for instructions to get s
23
26
24
27
### Developer Console
25
28
26
-
Manage, distribute and monitor Forge apps using the [Developer console](https://developer.atlassian.com/platform/forge/manage-your-apps/).
29
+
Manage, distribute and monitor Forge apps using the
This includes the `id` of the app within Atlassian Cloud. Change this value to deploy code to a different app, e.g. one created in a developer account.
36
+
This includes the `id` of the app within Atlassian Cloud. Change this value to deploy code to a different app, e.g. one
37
+
created in a developer account.
33
38
34
39
### Source Code
35
40
36
-
The three entry points to the app are contained in the `src/index.jsx` file. These define React components for App Settings, Project Settings and Issue Panel.
41
+
The three entry points to the app are contained in the `src/index.jsx` file. These define React components for App
42
+
Settings, Project Settings and Issue Panel.
37
43
38
44
### Linting and Formatting
39
45
40
-
The Atlassian template provided some basic eslint config, to which sensible TypeScript/React/Prettier defaults have been added.
46
+
The Atlassian template provided some basic eslint config, to which sensible TypeScript/React/Prettier defaults have been
47
+
added.
41
48
42
49
Execute `npm run eslint` to check linting and formatting.
43
50
@@ -51,23 +58,29 @@ Forge apps may be deployed to one of three environments:
51
58
52
59
Once an app is running in an environment, you can install it from that environment onto an Atlassian site.
53
60
54
-
By default, the CLI commands affect the development environment unless you specify another with the `--environment` flag. All the commands provide help given the `--help` flag.
61
+
By default, the CLI commands affect the development environment unless you specify another with the `--environment`
62
+
flag. All the commands provide help given the `--help` flag.
55
63
56
64
First ensure you're in the `flagsmith-jira-app` folder, not the containing folder.
57
65
58
66
Use the `deploy` command and follow the prompts to persist code changes:
59
67
60
68
forge deploy
61
69
62
-
Forge handles version numbering itself - the version number in `package.json` is not used. Generally, deployments that involve a change to permissions or authn/authz in `manifest.yml` cause a major increment and require the user to accept these changes to upgrade their installation. Other deployments cause a minor increment and upgrades are installed automatically.
70
+
Forge handles version numbering itself - the version number in `package.json` is not used. Generally, deployments that
71
+
involve a change to permissions or authn/authz in `manifest.yml` cause a major increment and require the user to accept
72
+
these changes to upgrade their installation. Other deployments cause a minor increment and upgrades are installed
73
+
automatically.
63
74
64
-
See [Environments and versions](https://developer.atlassian.com/platform/forge/environments-and-versions/) for more information.
75
+
See [Environments and versions](https://developer.atlassian.com/platform/forge/environments-and-versions/) for more
76
+
information.
65
77
66
78
Use the `install` command and follow the prompts to install the app on a new site:
67
79
68
80
forge install
69
81
70
-
Once the app is installed on a site, the site picks up changes you deploy without needing to rerun the install command. For major version changes the `--upgrade` flag must be used.
82
+
Once the app is installed on a site, the site picks up changes you deploy without needing to rerun the install command.
83
+
For major version changes the `--upgrade` flag must be used.
71
84
72
85
### Debugging and Development
73
86
@@ -79,12 +92,16 @@ To switch this off again:
79
92
80
93
forge variables unset DEBUG
81
94
82
-
Use the `tunnel` command to test code (but not manifest) changes without having to deploy them (development environment only). This proxies invocations when you use the app to your local environment. To set environment variables, prefix them with `FORGE_USER_VAR_`:
95
+
Use the `tunnel` command to test code (but not manifest) changes without having to deploy them (development environment
96
+
only). This proxies invocations when you use the app to your local environment. To set environment variables, prefix
97
+
them with `FORGE_USER_VAR_`:
83
98
84
99
FORGE_USER_VAR_DEBUG=1 forge tunnel
85
100
86
-
This command may report a "Checking Docker image... failed" error and then work anyway. This [may be resolved](https://community.developer.atlassian.com/t/forge-tunnel-error-checking-docker-image/45490/14) by typing `export DOCKER_CLI_HINTS=false` first.
87
-
See [Tunneling](https://developer.atlassian.com/platform/forge/tunneling/) for more information on testing using local files and servers.
101
+
This command may report a "Checking Docker image... failed" error and then work anyway. This
102
+
[may be resolved](https://community.developer.atlassian.com/t/forge-tunnel-error-checking-docker-image/45490/14) by
103
+
typing `export DOCKER_CLI_HINTS=false` first. See [Tunneling](https://developer.atlassian.com/platform/forge/tunneling/)
104
+
for more information on testing using local files and servers.
88
105
89
106
Use the `logs` command to see logs (development/staging environment only):
0 commit comments