Jelly Programming Language

What is the Jelly Language?

• The Jelly language is a simply written program language that allows you to write Siri Shortcuts. The Jelly language is set up in a way that makes it easy to quickly learn and adapt from the Shortcuts app to Jelly.
• This documentation will bring you through learning the entire language

Specifics of the Jelly Language

Variables in Jelly

• Variables are extremely simple in the Jelly language, however they do have some quirks inherited from Shortcuts.

• Referencing Variables

  • Variables are used within the parameters of functions and when assigning variables.
  • Magic Variables are not referenced any differently than normal variables.
  • Examples:

airdrop(file: Shortcut Input)
// Here we used a Global variable for the parameter.
airdrop(file: MyFilteredImage)
// Here we are using a local variable for the parameter.

1. Assigning variables
   • Assigning a variables var •var name• = •magic variable | global variable•
   • Assigning a magic variable function() ->[name]
2. What is a Magic Variable?
   • Magic variables are almost exactly the same as regular variables. The only difference is how they are declared and they can not be reassigned. Think of them like constants.
   • A magic variable is a variable that contains the output of a function. Functions are casted into magic variables using ->[•name•]
3. Adding variables into text
   • In text variables can be used in a lot of different places across the app. They are most notably used in the Text action and whenever you are mixing variables with any text.
   • To use an in-text variable simply place ${Variable Name} within any string that excepts in text variables.
   • Example: " Hello ${world name}!"

Creating your first Jellycut

A Jellycut is just a shortcut written in the Jelly Language

1. Import the Shortcuts package into your Jellycut
   • This can be done by adding import Shortcuts 1090.2 to the top of your file.
   • You can view all of the available packages in the Libraries documentation entry.
2. Write your first simple Jellycut
   • Our simple Jellycut will take the device input and copy it too the clipboard

     import Shortcuts 1090.2
     var sc = Shortcut input
     setClipboard(variable: sc)
     

3. Writing your first if statement
   • We are going to expand upon our starting Jellycut and add in an if statement that checks if the URL contains the text Hello World

     import Shortcuts 1090.2
     var sc = Shortcut input
     if(sc .contains " Hello World" ) {
     setClipboard(variable: sc)
     }
     

4. Expanding on your if statement
   • We are going to expand upon our current if statement and add an alert that tells the user their shortcut input did not contain the text Hello World

     import Shortcuts 1090.2
     var sc = Shortcut input
     if(sc .contains " iCloud" ) {
     setClipboard(variable: sc)
     } else {
     alert(message: " Your clipboard does not contain the phrase Hello World" )
     }
     

5. Incorporating variables into your Jellycut
   • We are now going to add some variables into our shortcut to tell the user what their input was in the alert, along with telling them the text was successfully copied.

     import Shortcuts 1090.2
     var sc = Shortcut input
     if(sc .contains " iCloud" ) {
     setClipboard(variable: sc)
     sendNotification(body: "${sc} copied to clipboard" , title: " Successfully copied to clipboard" )
     } else {
     alert(message: " Your clipboard does not contain the phrase Hello World" )
     }