Setup Uniform project

Goals

In Uniform, most of the settings that control classification, personalization and layout for your web application are set and stored in a project. In order to configure these things, you need a project. This involves the following:

• Understand what a Uniform project is.
• Create a new Uniform project using the Uniform dashboard.
• Understand what a Uniform API key is.
• Create a new Uniform API key.

Create project

Projects are created and configured using the Uniform dashboard.

1. Log into the Uniform dashboard at https://uniform.app

2. Create the following project:

   • Project name: Getting Started Tutorial

3. The project dashboard page is displayed.

   

Add API key

Your web application will need to read data & settings from the Uniform project. This requires a valid API key be assigned to the project, and for the right permissions assigned to the key.

1. In the Uniform team home page, navigate to Security > API Keys.

2. Add the following API key:

   Name	Getting Started Tutorial key
   Project	Getting Started Tutorial

3. Enable the following permissions:

   Uniform Canvas > Compositions > Read Draft
   Uniform Canvas > Compositions > Read Published
   Uniform Context > Read Drafts
   Uniform Context > Manifest > Read

4. Click Set Permissions.

5. Click Create API Key.

6. Two values are displayed: the API key and the project ID. Copy both of these values. You will need them later.

   
   caution

   This is the only time the API key will be displayed. If you lose the value you will need to create a new one.