Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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

Expand
titleStep 1: Add a component using green [+ COMPONENT] button

Create a Component

Include Page
Create a Component
Create a Component
Expand
titleStep 2: Make sure it has an upstream repo

Set an upstream repository & Set upstream Git repo

Include Page
Set an upstream repository
Set an upstream repository
Expand
titleStep 3: Create a directory FOO
  • Click the Create Folder icon

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

  • You should see something like this:

Expand
titleStep 4: Create a file BAR.lua in the FOO directory with and add a function
  • 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:

  • Code Block
    function FOObar()
       return "The world needs more FOO";
    end
  • You should see something like this:

Expand
titleStep 5: Commit the changes and push them to the upstream repo
  • 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

Expand
titleRight click and convert FOO to a libraryStep 6: Convert FOO to a library by right clicking on it and choosing the "Create Library" menu option
  • 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

    Image Added
  • 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

Note

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.

If you look at the FOO library it
Expand
titleStep 7: Commit and push
the FOO library changes

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

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

If you look at the repo for the component it should have the link to the library in it. It doesn’t currently - there is a bug.
  • Image Added
Expand
titleStep 8: Now create a new component + FROM URL based on the git repo of this library

Bang - this work flow is currently broken as of 10.1.80

...