Skip to content

Commit 4075a98

Browse files
Update developer portal documentation
1 parent 5cfae06 commit 4075a98

File tree

10 files changed

+48
-82
lines changed

10 files changed

+48
-82
lines changed

_config.yml

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -73,7 +73,8 @@ links:
7373
pebble_tool_root: https://s3.amazonaws.com/assets.getpebble.com/pebble-tool/
7474
libpebble: https://github.com/pebble-dev/libpebble2
7575
kickstarter3: https://www.kickstarter.com/projects/597507018/pebble-2-time-2-and-core-an-entirely-new-3g-ultra
76-
discord_invite: http://discord.gg/aRUAYFN
76+
discord_invite: https://rebble.io/discord
77+
rebble_tos: https://rebble.io/tos/
7778

7879
# Jekyll collections.
7980
collections:

source/_guides/appstore-publishing/index.md

Lines changed: 5 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@
1515

1616
title: Appstore Publishing
1717
description: |
18-
How to get your app ready for going live in the Pebble appstore.
18+
How to get your app ready for going live in the Rebble appstore.
1919
guide_group: appstore-publishing
2020
menu: false
2121
permalink: /guides/appstore-publishing/
@@ -26,9 +26,9 @@ hide_comments: true
2626
When a developer is happy that their app is feature-complete and stable, they
2727
can upload the compiled `.pbw` file to the
2828
[Developer Portal]({{ site.links.devportal }}) to make it available on the
29-
Pebble appstore for all users with compatible watches to share and enjoy.
29+
Rebble appstore for all users with compatible watches to share and enjoy.
3030

31-
In order to be successfully listed in the Pebble appstore the developer must:
31+
In order to be successfully listed in the Rebble appstore the developer must:
3232

3333
* Provide all required assets and marketing material.
3434

@@ -38,11 +38,10 @@ In order to be successfully listed in the Pebble appstore the developer must:
3838

3939
* Build their app with a non-beta SDK.
4040

41-
* Ensure their app complies with the various legal agreements.
41+
* Ensure their app complies with the various [legal agreements]({{ site.links.rebble_tos }}).
4242

4343
Information on how to meet these requirements is given in this group of guides,
44-
as well as details about available analytical data for published apps and
45-
example asset material templates.
44+
as well as details about example asset material templates.
4645

4746

4847
## Contents

source/_guides/appstore-publishing/preparing-a-submission.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -27,9 +27,9 @@ privately. The appstore is built into the official mobile apps and means that
2727
every new app can be found and also featured for increased exposure and
2828
publicity.
2929

30-
> Note: An app can only be published privately while it is not already published
31-
> publicly. If an app is already public, it must be unpublished before it can be
32-
> made private.
30+
# > Note: An app can only be published privately while it is not already published
31+
# > publicly. If an app is already public, it must be unpublished before it can be
32+
# > made private.
3333

3434
To build the appstore listing for a new app, the following resources are
3535
required from the developer. Some may not be required, depending on the type of
@@ -80,6 +80,8 @@ releases.
8080

8181
## Companion Apps
8282

83+
> This functionality is coming to the Rebble Developer Portal in a future release.
84+
8385
If your app requires an Android or iOS companion app to function, it can be
8486
listed here by providing the name, icon, and URL that users can use to obtain
8587
the companion app. When a user install the watchapp, they will be prompted to
@@ -96,9 +98,7 @@ timeline' to obtain API keys used for pushing pins. See the
9698
## Promotion
9799

98100
Once published, the key to growth in an app is through promotion. Aside from
99-
users recommending the app to each other, posting on websites such as the
100-
[Pebble Forums](https://forums.getpebble.com/categories/watchapp-directory),
101-
[Reddit](https://www.reddit.com/r/pebble), and [Twitter](https://twitter.com)
101+
users recommending the app to each other, posting on websites such as [Reddit](https://www.reddit.com/r/pebble) or the [Rebble Discord Server]({{ site.links.discord_invite }})
102102
can help increase exposure.
103103

104104

source/_guides/appstore-publishing/publishing-an-app.md

Lines changed: 35 additions & 69 deletions
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ order: 1
2121
---
2222

2323
When an app is ready for publishing, the `.pbw` file needs to be uploaded to the
24-
Pebble [Developer Portal]({{ site.links.devportal }}), where a listing is
24+
Rebble [Developer Portal]({{ site.links.devportal }}), where a listing is
2525
created. Depending on the type of app, different sets of additional resources
2626
are required. These resources are then used to generate the listing pages
2727
visible to potential users in the Pebble appstore, which is embedded within the Pebble mobile app.
@@ -50,103 +50,69 @@ resources are before creating the listing.
5050

5151
## Publishing a Watchface
5252

53-
1. After logging in, click 'Add a Watchface'.
53+
1. After logging in to the Developer Portal, click '+ New App'. Press 'Next'.
5454

55-
2. Enter the basic details of the watchface, such as the title, source code URL,
56-
and support email (if different from the one associated with this developer
57-
account):
55+
2. Enter the basic details of the Watchface, such as the title, type,
56+
and a description:
5857

5958
![face-title](/images/guides/appstore-publishing/face-title.png)
6059

61-
3. Click 'Create' to be taken to the listing page. This page details the status
62-
of the listing, including links to subpages, a preview of the public page,
63-
and any missing information preventing release.
60+
3. Click 'Next' to be taken to the images page. Here you should upload screenshots for each platform your Watchface supports.
61+
![add-images](/images/guides/appstore-publishing/new-add-image.png)
6462

65-
![face-listing](/images/guides/appstore-publishing/face-listing.png)
63+
Further down the page is the option to upload a banner. During inital submission, you can provide one banner. After
64+
your app is submitted, you will be able to provide up to 3 banners per platform if desired. Press 'Next'.
6665

67-
4. The status now says 'Missing: At least one published release'. Click 'Add a
68-
release' to upload the `.pbw`, optionally adding release notes:
66+
4. The next step is to optionally provide a website link and a source code link. Both fields can be left blank if desired.
6967

70-
![face-release](/images/guides/appstore-publishing/face-release.png)
68+
![add-source](/images/guides/appstore-publishing/new-add-source.png)
7169

72-
5. Click 'Save'. After reloading the page, make the release public by clicking
73-
'Publish' next to the release:
70+
5. Click 'Next'. The final page requires you to provide release notes for your first release, as well as the .pbw file.
7471

75-
![face-release-publish](/images/guides/appstore-publishing/face-release-publish.png)
72+
![face-release-publish](/images/guides/appstore-publishing/new-add-release.png)
7673

77-
6. The status now says 'Missing: A complete X asset collection' for
78-
each X supported platform. Click 'Manage Asset Collections', then click
79-
'Create' for a supported platform.
80-
81-
7. Add a description, up to 5 screenshots, and optionally a marketing banner
82-
before clicking 'Create Asset Collection'.
83-
84-
![face-assets](/images/guides/appstore-publishing/face-assets.png)
85-
86-
8. Once all asset collections required have been created, click 'Publish' or
87-
'Publish Privately' to make the app available only to those viewing it
88-
through the direct link. Note that once made public, an app cannot then be
89-
made private.
90-
91-
9. After publishing, reload the page to get the public appstore link for social
92-
sharing, as well as a deep link that can be used to directly open the
93-
appstore in the mobile app.
74+
Once you have submitted this information, and you are happy with the submission, press 'Publish App to Store' to submit your app!
9475

9576

9677
## Publishing a Watchapp
9778

98-
1. After logging in, click 'Add a Watchapp'.
79+
1. After logging in to the Developer Portal, click '+ New App'. Press 'Next'.
9980

100-
2. Enter the basic details of the watchapp, such as the title, source code URL,
101-
and support email (if different from the one associated with this developer
102-
account):
81+
2. Enter the basic details of the App, such as the title, type, category and a description:
10382

104-
![app-title](/images/guides/appstore-publishing/app-title.png)
83+
![face-title](/images/guides/appstore-publishing/new-add-watchapp.png)
10584

106-
3. Select the most appropriate category for the app, depending on the features
107-
it provides:
108-
109-
![app-category](/images/guides/appstore-publishing/app-category.png)
110-
111-
4. Upload the large and small icons representing the app:
112-
113-
![app-icons](/images/guides/appstore-publishing/app-icons.png)
85+
3. Click 'Next' to be taken to the images page. Here you should upload screenshots for each platform your App supports.
86+
![add-images](/images/guides/appstore-publishing/new-add-image.png)
11487

115-
5. Click 'Create' to be taken to the listing page. This page details the status
116-
of the listing, including links to subpages, a preview of the public page,
117-
and any missing information preventing release.
88+
Further down the page is the section to upload a banner. During inital submission, you can provide one banner. After
89+
your app is submitted, you will be able to provide up to 3 banners per platform if desired.
11890

119-
![app-listing](/images/guides/appstore-publishing/app-listing.png)
91+
You must also provide a large icon and small icon for your Watch App.
12092

121-
6. The status now says 'Missing: At least one published release'. Click 'Add a
122-
release' to upload the `.pbw`, optionally adding release notes:
93+
![add-banners](/images/guides/appstore-publishing/new-add-banner.png)
12394

124-
![app-release](/images/guides/appstore-publishing/app-release.png)
95+
4. The next step is to optionally provide a website link and a source code link. Both fields can be left blank if desired.
12596

126-
7. Click 'Save'. After reloading the page, make the release public by clicking
127-
'Publish' next to the release:
97+
![face-release](/images/guides/appstore-publishing/new-add-source.png)
12898

129-
![face-release-publish](/images/guides/appstore-publishing/face-release-publish.png)
99+
5. Click 'Next'. The final page requires you to provide release notes for your first release, as well as the .pbw file.
130100

131-
8. The status now says 'Missing: A complete X asset collection' for
132-
each X supported platform. Click 'Manage Asset Collections', then click
133-
'Create' for a supported platform.
101+
![face-release-publish](/images/guides/appstore-publishing/new-add-release.png)
134102

135-
9. Add a description, up to 5 screenshots, optionally up to three header images,
136-
and a marketing banner before clicking 'Create Asset Collection'.
103+
Once you have submitted this information, and you are happy with the submission, press 'Publish App to Store' to submit your app!
137104

138-
![app-assets](/images/guides/appstore-publishing/app-assets.png)
139105

140-
10. Once all asset collections required have been created, click 'Publish' or
141-
'Publish Privately' to make the app available only to those viewing it
142-
through the direct link.
143-
144-
11. After publishing, reload the page to get the public appstore link for social
145-
sharing, as well as a deep link that can be used to directly open the
146-
appstore in the mobile app.
106+
## Publishing a Companion App
147107

108+
<div class="alert alert--fg-white alert--bg-orange">
109+
{% markdown %}
110+
**Legacy Section**
148111

149-
## Publishing a Companion App
112+
The Rebble Developer Portal does not yet support companion apps. The legacy Pebble documentation is currently preserved here for reference.
113+
If you wish to publish or update a companion app, please get in touch via [Discord]({{ site.links.discord_invite }}).
114+
{% endmarkdown %}
115+
</div>
150116

151117
> A companion app is one that is written for Pebble, but exists on the Google
152118
> Play store, or the Appstore. Adding it to the Pebble appstore allows users to
-52.3 KB
Loading
81.2 KB
Loading
58.5 KB
Loading
63.4 KB
Loading
45.5 KB
Loading
63.8 KB
Loading

0 commit comments

Comments
 (0)