Slapdash Platform
GitHub
  • Ahoy, world!
  • Command Bar 101
    • How it Works
    • Core Terminology
    • Commands
    • Local Commands
    • Cloud Commands
    • Build Your First Command
    • Publish Command
    • Hooks
  • Command Tutorials
    • Toggle Dark Mode
    • Emoji Paster
    • Copy Special Character
    • Send Slack Message
  • Reference
    • Command Response
    • Action
    • View
    • List View
    • Masonry View
    • Form View
    • Tokens
    • Icon
    • Config
Powered by GitBook
On this page
  • Create Command
  • Do Something with the Command
  1. Command Bar 101

Build Your First Command

PreviousCloud CommandsNextPublish Command

Last updated 3 years ago

Slapdash works great in the browser, but for the best development experience, we recommend using the .

There are : 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 you are comfortable with.

Create Command

  • Create an empty file with a .js extension (for example: ahoy-world.js)

  • Run Create New Command in the Command Bar and choose Local Script

  • Choose the file you created by clicking the Select File button.

  • Give the command a name, for example, "Run Demo"

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 .

The most basic thing a command can do is return an Action as the . 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

const response = {
  action: {
    type: "open-url",
    url: "https://slapdash.com/"
  }
}

// Print the response as JSON string
console.log(JSON.stringify(response));

Make Your Command Add Some Text to Your Clipboard

const response = {
  action: {
    type: "copy",
    value: "Ahoy world!"
  }
}

// Print the response as JSON string
console.log(JSON.stringify(response));

Another type of Action is to add something to your clipboard. You can see other Actions in the .

Command Response Reference
Slapdash desktop app
Command Response Specification
Command Response
two types of commands
whatever language