Setup

CAKE UI Fundamental library is a rudimentary symbol library and has to be linked first in Sketch in order for all the other CAKE UI products to work (e.g. App, Chatbot, Web, Mail, … ).


Option 1: Smart links#

By opening the smart links, Sketch application is going to automatically add the corresponding library to your list of libraries. In case of library updates you will receive a notification in Sketch that a library update is available.

ProjectSmart link
FundamentalOpen in Sketch
WebOpen in Sketch

Option 2: External software#

Applications like for example Sourcetree can be used to get access to our CAKE libraries and the repositories below have to be cloned there.

Follow this tutorial if you:

  1. are not linked to the world of CAKE.
  2. have not cloned any repositories.
  3. have not added library files and have not used plugins in Sketch.

Clone repositories#

 Steps DescriptionPreview
1Add new GitHub repositories by using the "New" select-field and choose "Clone from URL".Step 1: Add new repository
2Copy the required GitHub URL from the table above and paste it into the first input-field called "Source URL".Step 2: copy-path
3Tab to the next input-field and click on "…" to choose the correct destination path.Step 3: Choose destination
4Create a new folder with the name of the repository on your local computer (e.g. under ../Schwarz-UX/Libraries/…).Step 4: Create new folder
5Complete this process by hitting the button "Clone".Step 5: Clone

Add libraries#

 Steps DescriptionPreview
1Go to the preferences section in your Sketch software.Step 1: Preferences
2Choose the tab "Libraries" to show an overview of all your linked library files in Sketch.Step 2: Libraries
3Click on the "Add Library…" button and choose the library file (e.g. SCHWARZ CAKE UI Fundamental) from your new cloned folder.Step 3: Add library

Advanced#

Follow this tutorial if you already:

  1. are linked to the world of CAKE.
  2. have cloned repositories before.
  3. have added libraries and have installed plugins in Sketch.

Replace repositories#

  • Disconnect your VPN if you are signed in to the SCHWARZ network and …
  • Switch your WiFi connection to a free wifi (e.g. welcome@schwarz) if you are working in one of our offices.
 Steps DescriptionPreview
1Go to Sourcetree, right-click on a cloned repository and choose delete (e.g. SCHWARZ CAKE UI Core).Step 1: Delete
2Confirm your remove by clicking on "Also Move to Trash".Step 2: Confirm remove
3Add new GitHub repositories by using the "New" select-field and choose "Clone from URL".Step 3: Add new repository
4Copy the required GitHub URL from the table above and paste it into the first input-field called "Source URL".Step 4: copy-path
5Tab to the next input-field and click on "…" to choose the correct destination path.Step 5: Choose destination
6Create a new folder with the name of the repository on your local computer (e.g. under ../Schwarz-UX/Libraries/…).Step 6: Create new folder
7Complete this process by hitting the button "Clone".Step 7: Clone

Locate missing libraries#

 Steps DescriptionPreview
1Go to the preferences section in your Sketch software.Step 1: Preferences
2Choose the tab "Libraries" to show an overview of all your linked library files in Sketch.Step 2: Libraries
3Right-click on the missing library file and locate it again to your new cloned folder.Step 3: Locate library

Change log#

Added#

  • Doc: "Setup" | Added Sketch smart links

Changed#

  • Doc: "Setup" | Clean up the documentation for the right structure and sentence case