Publish Command
Share your command with the Slapdash community
Once you're happy with your command you may want to share it with others.
A published command will appear as a "Community Command" on the Slapdash developer site, allowing anyone to discover it and add it to their Slapdash account.

Publish Cloud Command

To publish a command, you need to fork the slapdash/platform repository, create a new folder inside commands and then open a Pull Request. Once your PR is merged, your command will appear on the Slapdash site, allowing anyone to install it. Each command gets its own folder and needs to follow some simple conventions. Here's an example of how a new command might be added to the repository.
Please name your command folder using the kebab case style (lowercase and hyphen used as a separator).
1
commands
2
└── my-command-name
3
├── command.toml
4
├── icon.svg
5
└── screenshot.json
Copied!
Each command folder needs to have three files: command.toml, icon.svg and screenshot.json. You can copy other commands as examples, or read about the role of each file below.

command.toml

This is a simple TOML file that contains metadata about your command.
Name
Details
name
Required. Name of the command, prefer <Verb> <Noun> convention
description
Required. Short, one-sentence description
endpointURL
Required. Publicly accessible HTTPS endpoint for your command
author.name
Required. Full name of the command's author
author.profileURL
Required. Link to the author's public profile. For example, a link to a Github or Twitter profile.
categories
List of categories the command belongs to. You can grab them from the list below or put something else.
readme
Long-form explanation of the command. You can use Markdown if you want.
language
Language that was used to build the command. For example, "TypeScript" or "Python".
sourceCodeURL
Link to the source code of your command. For example, a link to a public Github repository.

icon.svg or icon.monochrome.svg

This is the icon that will be used alongside your command, when it appears in the Command bar. If you want Slapdash to automatically change the icon's color based on the selected theme, use icon.monochrome.svg.
We recommend a 64x64 px icon with no padding around it. If you need help finding an icon, you can try using the Search Iconfinder command.

screenshot.json

This file is added by Slapdash employees so you don't need to provide it. It is a simple JSON file that contains one of the Command Responses that your command returned as well as some other metadata to help visualize the command on the Slapdash site.

Publish Local Command

There is currently no way to publish a Local Command but we're actively working on it. It should be available very soon. Stay tuned!

Categories

If you're not sure what category to put your command in, don't sweat it, we'll help categorize it. Here are some potential categories you might want to consider (or, just make up your own).
    Automation
    Books
    Business
    Developer Tools
    Education
    Entertainment
    Finance
    Food & Drink
    Games
    Health & Fitness
    Design
    Lifestyle
    Kids
    Magazines & Newspapers
    Medical
    Music
    Navigation
    News
    Photo & Video
    Productivity
    Shopping
    Social Networking
    Sports
    Travel
    Utilities
Last modified 15d ago