Build Your First Command
Slapdash works great in the browser, but for the best development experience, we recommend using the Slapdash desktop app.
There are two types of commands: Local Commands, which are scripts that run on your computer, and Cloud Commands, which are commands that are hosted on the web. Developing is easier and faster with files on your computer, so that's the type of command we'll be writing here.
This example command will be written in JavaScript, but in practice, you can use whatever language you are comfortable with.

Create the Command

    Create an empty file with a .js extension (for example: ahoy-world.js)
    Run Create Command in the Command Bar and choose Custom
    Give the command a name, for example, "Run Demo"
    Choose Script on my computer as Command Type and select the file you created

Do Something with the Command

For the Command to do something or show something in the Command Bar, it just needs to print some text. Specifically, the text needs to be JSON that matches the shape of the Command Response Specification.
The most basic thing a command can do is return an Action as the Command Response. An Action just tells the Command Bar to do some operation and exit. The simplest one is to just open a URL.

Make Your Command Open a URL

1
const response = {
2
action: {
3
type: "open-url",
4
url: "https://slapdash.com/"
5
}
6
}
7
8
// Print the response as JSON string
9
console.log(JSON.stringify(response));
Copied!
Another type of Action is to add something to your clipboard. You can see other Actions in the Command Response Reference.

Make Your Command Add Some Text to Your Clipboard

1
const response = {
2
action: {
3
type: "copy",
4
value: "Ahoy world!"
5
}
6
}
7
8
// Print the response as JSON string
9
console.log(JSON.stringify(response));
Copied!
Last modified 5d ago