Public project pages
A public project page is a build page anyone can open without a token or an account. Reach for it when a build should be findable by everyone who holds the link, not by one reviewer.
Quick start
Set the project's visibility to public in project settings:
console.extension.dev/<workspace>/<project>/project-settings/visibilityThe project then answers at <workspace>.extension.dev/<project>. Every build under it gets an address of its own, and every channel gets a short alias.
How it works
The workspace lives in the host, not in a path segment, so a link carries the workspace identity before the page loads. A project has three kinds of page:
- The project page, with the tabs Overview, What's new and Versions.
- The version page of one build, at
/builds/<sha>. It runs the build, lists every browser it produced, and shows what is new in it. - The browser build page of one browser in that build, at
/builds/<sha>/<browser>.
A channel is not a fourth page. It is an alias. /<project>/preview shows the version that the Preview channel serves now, in place, with no redirect. A saved channel link stays current when you release a new version to the channel. A bar at the top names the channel and the version, for example Preview · 0.3.0. That label links to the fixed address of the version, /builds/<sha>. Add a browser to reach its build on the channel, as in /<project>/preview/chrome.
Any other address under the project answers a page that reads "There's nothing at this address". It does not redirect.
The per-browser build page is where strangers land. It offers the artifact as a zip, the executable downloads where the build produced them, and an Access tab titled What this build asks for. That tab lists each host pattern, permission and optional permission the manifest declares, with a line on what it unlocks.
The same page shows the developer's browser captures under In Chrome, In Firefox, In Edge or In Safari, with the line "What the developer captured in Chrome 142." A capture is a real screenshot of the extension running in that browser. The developer makes it with extension_screenshot and sends it with extension_publish, or uploads it by hand under Browser captures in project settings. The platform never generates one. Safari with no captures shows the App Store set instead. Chrome, Firefox and Edge show nothing until a capture exists. Store screenshots are marketing and stay on the listing.
The zip streams straight from the registry at registry.extension.land/<workspace>/<project>/builds/<sha>/<browser>.zip as bytes with Content-Type: application/zip and no redirect, so a plain curl receives it. A public build's zip is cached as immutable for a year.
A project is either public or private, and the platform serves this page only for a project declared public. A project nobody declared is private. Two gates read the same declaration. The page gate hides the listing, the name, the icon and the changelog behind a card that names nothing. The registry gate answers 401 for the build bytes whether the file exists or not. A deny always wins, so a project declared private is refused even if an older allow entry is still around. A token scoped to the project opens both gates, so an owner's view keeps working while a stranger is turned away.
Making a project public exposes its listing and its builds. It does not expose build logs, store credentials or environment variables. Those never leave the console.
Visibility is a setting of the extension.dev project, not of its GitHub repository. Workspace owners and admins change it. Everyone else reads it. Changing it sets every channel's audience to match. A project connected through the console's onboard page starts with the visibility of its repository. A project created on /import starts private whatever its repository is. The platform re-declares the visibility to the registry on every completed build, so the declaration heals itself. The registry refreshes its lists about once a minute, so a change is not instant in either direction. Nothing recalls a file someone already downloaded.
Public does not mean indexed. The workspace subdomain refuses every search crawler in robots.txt and again with a noindex, nofollow tag on the page, so a public build page is reached by a link you send and not by a query someone types. Link preview bots are admitted by name, so a shared link unfurls where it lands: Twitterbot, facebookexternalhit, Slackbot, Slackbot-LinkExpanding, LinkedInBot, Discordbot, TelegramBot, WhatsApp, redditbot, Embedly, SkypeUriPreview, Mastodon and Bluesky. A private project unfurls to a card that names nothing, the same gate as the page.
A private project has no public project page. It shares one build with a build link, or a public channel with a channel link. See Build links and channel links. A member mints a token link with this call:
POST /api/projects/{id}/shareThe call needs buildSha, or a scope that names a build, a channel or the whole project, and takes ttlHours. It returns a shareUrl carrying a ?share= token, with its expiry and its scope. Any workspace member may call it. It refuses a public project with 400, because a public project already has a page.
Reference
| Path under the project root | Page | Contents |
|---|---|---|
| (the root) | Project page | The Overview tab: the listing |
/whats-new | Project page | The What's new tab |
/versions | Project page | The Versions tab |
/builds/<sha> | Version page | The build running, every browser it produced, what is new |
/builds/<sha>/<browser> | Browser build page | Zip download, executable downloads |
/builds/<sha>/<browser>/access | Browser build page | The Access tab: what this build asks for |
/<channel> | Alias | The version page the channel serves now |
/<channel>/<browser> | Alias | That browser's build page on the channel now |
A build id is the lowercase commit sha, 7 to 40 characters. A browser is chrome, edge, firefox or safari.
Two files sit beside the pages. Firefox reads them to update an unlisted add-on. See Firefox Add-ons.
| File under the project root | Contents |
|---|---|
/channels/<channel>/updates.json | The Firefox update manifest of the channel |
/channels/<channel>/firefox.xpi | The signed Firefox package of the channel |
| Gate | What it protects | What a stranger gets |
|---|---|---|
| The page | The listing, the name, the icon, the changelog | A card that names nothing |
| The registry | The build bytes | 401, whether the file exists or not |
| Share call | Value |
|---|---|
ttlHours | 7 days (168 hours) by default, from 1 hour up to the plan's share window: 30 days on Free, 365 days on Pro |
buildSha | Points the link at /builds/<sha> and opens only that build |
scope | {kind: "build", name: "<sha>"}, {kind: "channel", name: "<channel>"} or {kind: "project"}. Without scope or buildSha, 400 SCOPE_REQUIRED |
| Public project | 400 "Project is public; share links are unnecessary." |
| Non-member | 403 |
When it fails
- The page shows a brand card instead of your project: visibility is not public. That is the gate working. Set it under Visibility in project settings.
POST /api/projects/{id}/shareanswers400: the project is public. Link the page itself.- A channel link says "This link doesn't resolve": the name is not a release channel of this project, or the link is out of date. Check the name, or release a build to that channel.
- A channel link says "Nothing is on Preview yet": the channel exists, but no version was released to it. Release one.
- An old link says "There's nothing at this address": the link uses a form that is not in the table above, such as
/channels/<channel>or/versions/<version>. Send the version page or the channel alias instead. - A share link says it has expired: a share token cannot be renewed. Mint a new one, or send a channel link, which never expires.
- The page never appears in a search engine: it is not meant to. Send the address, or paste it somewhere a link preview renders it.
Next
- Build links and channel links for which link to send
- Share an unpublished build for review for one reviewer instead of everyone
- Releases for how a build reaches a channel
- Publishing for the store lanes