Share libraries

In WeWeb, you can work with shared libraries.

These libraries can come from other projects in your workspace, or from the WeWeb marketplace:

Common use cases for working with shared libraries include but are not limited to:

• Leveraging popular libraries to build faster
• Working with a single UI kit across multiple projects for a company that requires you to follow strict brand guidelines

Share a library

To share a library with the rest of your workspace:

1. Open the project where you built the library you want to share
2. Click on the Assets tab in the Interface section
3. Select Library
4. Click on the Share button in the top right
5. Name your commit and add a description
6. Click Share to make the library available to your workspace

Add a shared library

To view and add shared libraries:

1. Click on the Assets tab in the Interface section
2. Select Library
3. Click on the book icon to view Available and Marketplace libraries

The Available tab lists:

• All the libraries that have already been added to the current project, including marketplace libraries
• All the libraries that have been shared in your workspace but haven't yet been added to the current project

The Marketplace tab lists all the libraries from the WeWeb marketplace that can be added to the current project.

To start using one of these libraries in your project, simply click on Add:

This will move the library up to the Added section of the panel in the Available tab, like the "Habit tracker" library in the example above.

WARNING

Can't find the library you're looking for?

Open the project with the source library you're looking for, go to the Assets tab → Library, and click on Share as described in the "Share a library" section above.

Remove a library

To remove an external library that you added to a project:

1. Click on the Assets tab in the Interface section
2. Select Library
3. Click on the book icon to open the shared libraries panel
4. In the Added section, select the library you want to remove
5. Click on the three dots (•••) menu
6. Click on Remove from project

Update a shared library

Whether you are sharing a library with others or working with an external library others shared with you, you will want to make changes and updates at some point.

There are three steps to updating a shared library:

1. Make the changes in the library
2. Publish those changes so they are available to other projects in the workspace
3. Update the library in the projects that use it

1. Make changes to a shared library

To make changes to a shared library, simply go to that project and make all the changes you want.

For example, you could edit a typography, add or delete spacings, templates, or components.

2. Publish changes of a shared library

Once you are ready to commit those changes to make them available to other projects in the workspace:

1. Click on the Assets tab in the Interface section
2. Select Library
3. Click on Share
4. Fill out the commit message
5. Click Share to publish your changes

TIP

Try to be descriptive when adding a commit message to library updates.

This will help users of your library understand what's new and how a library update might affect their projects.

3. Update the library in the projects that use it

Once the changes to a library have been shared to the workspace, you will see a notification in the projects that use it.

When you're ready to update:

1. Click on the Assets tab in the Interface section
2. Select Library
3. Click on the book icon to open the shared libraries panel
4. Find the library with updates available
5. Click Update to apply the latest changes

Use library versions

At times, you may want to rollback or rollforward to different versions of a shared library.

To change library versions:

1. Click on the Assets tab in the Interface section
2. Select Library
3. Click on the book icon to open the shared libraries panel
4. Find the library you want to change versions for
5. Click on the three dots (•••) menu
6. Select Change version
7. Choose the version you want to use