So you’re writing an interface and you make some useful routines and then you realize that you’d like to use this library in other components.

How do you do this?

You can create libraries which are then re-usable from any other Iguana X component.

Create a Component

Set an upstream repository & Set upstream Git repo

  • Click the Create Folder icon

  • Enter the folder name and click and click the green [CREATE] button

  • You should see something like this:

  • Select the Create File menu optin on the FOO folder

  • Enter the folder name and click and click the green [CREATE] button

  • Create a function in the BAR.lua file, you can paste this example:

  • function FOObar()
   return "The world needs more FOO";
end

  • You should see something like this:

  • Click the Commit changes toolbar button

  • The commit dialogue will open, enter a commit message and click the green [COMMIT] button

  • Click the Push changes to remote toolbar button

  • The upstream repository will look something like this:
    NOTE: FOO is currently just a folder

  • Open the folder menu by right clicking on FOO, or clicking the 3 dot menu

  • Choose Create Library to convert the FOO folder into a Library

  • Click the green [CREATE] button in the confirmation dialogue

  • This will bring you to the Repository Management dialogue

  • Once you are in the Repository Management screen you can set your upstream repository

    • Enter the name (also called a slug) for the repository

      • To create a new repository enter a repo name (slug) that does not exist yet

      • Click the [CONFIRM CHANGE] button to connect or create

It is possible to connect to an existing repository in the Repository Management dialogue – but we strongly recommend against this as there a few, if any, scenarios where this would be useful.

See Step 5 for detailed screenshots (the first three steps below are the same)

  • Click the Commit changes toolbar button

  • The commit dialogue will open, enter a commit message and click the green [COMMIT] button

  • Click the Push changes to remote toolbar button

  • The component upstream repository will look something like this:
    NOTE: Notice that FOO was converted from a folder (in step 3) to a reference to the FOO library

  • The FOO library upstream repository will look something like this:
    NOTE: That the the FOO library should have the BAR.lua file in it.

Bang - this work flow is currently broken as of 10.1.80