Repository navigation
Getting started
A project is your workspace in Ọkpan. Everything you work on lives inside a project: the institutions you add, your objects, the connections between them, and the website you publish at the end.
This page explains how to start a project from scratch, with a blank workspace.
Not starting from scratch?
- Someone already invited you? See Join a project.
- You have a project file exported from Ọkpan? See Import a project.
- Just want to look around? See Download a sample project.
Have these things ready:
- A title for your project, for example Digital Benin Objects.
- A short description (optional) that says what the project is about.
- The main language you will write your content in.
- Whether you will work alone or with other people. If others will work with you, choose a password for the project.
It takes about a minute.
When you open Ọkpan, you see the start screen. At the top, under Start from here, click Create a new project.
Under Your projects you will find all the projects you have created or joined. The first time, it says No projects yet.

A window opens with two short steps. The first step is Project details.

| Field | What to write | Required? |
|---|---|---|
| Project title | The name of your project. It is how you will find it in your list of projects. | Yes |
| Description | One or two sentences about what the project is about and what it contains. | No |
| Default language | The main language of your content. Ọkpan sets it to English to begin with. You can't change it later, so choose carefully. | Yes |
Fields marked with an asterisk (*) are required. The Next button only becomes active once these are filled in.

About languages: the default language can't be changed once the project is created. You can add other languages to your project later.
Click Next.
The second step is Sharing and security. Here you decide who can work on the project.

Do you want to make a collaborative project?
- Yes: other people can join the project and work on it with you. This is the default.
- No: the project is only for you, and the password options disappear. You can make it collaborative later.
Use password (only for collaborative projects)
- Yes: write a password in the Password box. People who want to join your project will need it. This is the default.
- No: people can join without a password.
Tip: Keep the password somewhere safe and share it only with people you want on the project. You can change or remove it later.
To change something in the first step, click Back. When you are ready, click Create.
Ọkpan opens your new project on the Overview page, which asks: Where would you like to begin?

From here you can:
- Add institution: add the museums, archives or libraries your objects come from.
- Import data: bring in many objects at once from a file.
- Connection types: set up the topics, ideas and media you want to link to your objects.
Start with an institution. Ọkpan recommends adding at least one institution first. Import data stays greyed out until you do, because every object has to belong to an institution.
Now that the project is open, three areas of the screen are useful to know.
- The project name (top left). Click it to open the project menu (see below).
- Data editor / Website preview (top centre). Switch between working on your data and seeing how it will look on the website. See Data editor vs Website preview.
-
The side menu (left). All the main sections of the project:
- Overview, Institutions, Objects, Connections: browse what is in your project.
- Add content: add institutions and objects, or import data and media.
- Publish: website settings, export the website, export your data.
- Settings: object fields and project settings.
Click the project name at the top left to open this menu:

- All projects: go back to the start screen and your list of projects.
- New project: start another project.
- Edit project info: change the details you entered when you created the project, such as the title and description.
- Get project sharing ID: get the code other people need to join your project. See Share project.
- Delete project: remove the project.
Can I change the title or description later? Yes. Open the project menu and choose Edit project info.
I chose "No" for collaborative. Can I share the project later? Yes. A project can be made collaborative at any time. See Share project.
Can I change the default language later? No. The default language is fixed when you create the project, but you can add other languages.
Can I change or remove the password? Yes, you can change it or remove it later. See Share project.
How do other people join my project? Send them the project sharing ID (from the project menu) and, if you set one, the password. They then follow the steps in Join a project.
Next step: Add institutions
Introduction
- What is Ọkpan? (soon)
- Where your data is stored (soon)
- Create a new project
- Import a project (soon)
- Join a project (soon)
- Download a sample project (soon)
Basic notions and navigation (soon)
Institutions (soon)
Objects (soon)
Import data and mapping (soon)
- Import data from an institution (soon)
- Map your data to Ọkpan's fields (soon)
- Import media (soon)
Connections (soon)
Publish your work (soon)
Object fields (soon)
Project settings (soon)