App specification

This is a sample specification:

{
	"$schema": "../app-spec-schema.json",
	"id": "rocks.m4.paquet",
	"author": "m4rocks",
	"githubUrl": "https://github.com/m4rocks/paquet",
	"features": ["desktop", "mobile", "openSource"],
	"authorUrl": "https://m4.rocks",
	"url": "https://paquet.m4.rocks",
	"updatedDate": "2025-04-14"
}

Keys

$schema (required)

This is required to provide type safety when adding the keys to the app schema.

id (required)

This is required. This must be the domain of your app reversed. If your app is hosted at a subdomain, append the pathname at the end.

Example 1: https://paquet.m4.rocks -> rocks.m4.paquet
Example 2: https://m4rocks.github.io/paquet -> io.github.m4rocks.paquet

url (required)

This is the URL to your app. This can point to your app’s landing page or the app itself.

manifestUrl (optional)

This is the url pointing to your app’s manifest. If your app generates different manifest files with a different pathname on every deployment, you can exclude this value as Paquet will dynamically look for your manifest file in your app.

It is typically recommended to include this in your app specification.

categories (optional)

This will include the categories that your app is included in. It is preferable to use the categories key in your app’s manifest.

features (required)

This represents the features that your app offers. The available features are:

• openSource: If the app is open source
• mobile: Is mobile optimized
• desktop: Is desktop optimized
• auth: Requires authentication
• offline: Works offline

author (required) & authorUrl (optional)

If you want to have a different author text from the one in your app’s manifest, you can add an author key. You can also add authorUrl to link to your website or GitHub profile. (authorUrl has been previously known as authorLink)

Additional keys

githubUrl & gitlabUrl (optional)

This URL points to the public repository of your app.

accentColor (optional)

This is if you want a separate theme color from the one in your app’s manifest.

certificateUrl (deprecated)

This URL points to your certificate that is used to prove ownership of your app.

version (deprecated)

This is used to keep track of the changes to your app specification You can use your app’s version as a string ("version": "1.0.0") or use a number and increment it on each app specification update ("version": 1)