> For the complete documentation index, see [llms.txt](https://prima-software-co.gitbook.io/primaguide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://prima-software-co.gitbook.io/primaguide/prima-admin-manual.md).

# prima admin manual

Welcome to Prima. This guide walks you through setting up and running your company, section by section. It follows the same order as your navigation, so whenever you're stuck on something specific, jump straight to that section.

Throughout, you'll also see **What your team sees** notes — quick explanations of how dancers and staff experience the things you set up, so you always know what's happening on the other end.

***

## Getting Started

Prima is built around a simple idea: you configure your company once, publish your schedule, and everyone stays in sync automatically. Before your team logs in for the first time, you'll want to work through the setup in roughly this order:

1. **Settings** — configure your company (facilities, ranks, season, financials, permissions)
2. **Staff** — add your people and send invites
3. **Productions** — set up your repertoire and build casts
4. **Schedule Editor** — build and publish your schedule
5. Everything else — treatment, touring, shoes, notifications, and financials as you need them

You don't have to finish everything before inviting your team, but setting up Facilities, Ranks, and your Season first will make everything afterward smoother.

***

## Settings

Settings is where you configure your company before anyone logs in. Everything here shapes how the rest of Prima behaves, so it's worth getting right up front.

### Facilities

Set up every location your company uses — studios, stages, physio and treatment rooms, costume fitting rooms, and anything else you schedule into.

Each facility you add becomes its own **column in the Schedule Editor**, so you can book rehearsals, performances, fittings, and treatments into specific spaces. Add them all here first, before you start scheduling.

### Company Settings

Your company's ranks, details, and branding live here.

**Ranks** — Turn on the ranks your company actually uses (Principal, Soloist, Corps, and so on). Ranks matter beyond organization: if you pay extras for certain roles by rank, Prima feeds that directly into your financial calculations.\
Selecting Ensemble Company disables ranks - hourly rates can still be set, with individual dancer overrides.

**Logo** — Upload your company logo here and it appears in the header of the Prima app and on printouts.

### Scheduling

A few simple but important settings that affect scheduling and record-keeping across the whole platform.

**Season windows** — Set your season start and end dates. This is important: season windows drive your financial calculations, dancer CV entries, and other historical records. Don't skip this.

**Default rehearsal duration** — Set a default length for new rehearsal blocks to speed up scheduling.

**Google Calendar sync** — Enable this so your team can subscribe to the company calendar directly from their Prima account. Prima creates and manages a dedicated Google Calendar for your company; your staff subscribe with one tap and see the schedule in Google Calendar if they prefer it there.

{% hint style="info" %}
**What your team sees:** Once you enable Google Calendar sync, every staff member finds a "Subscribe to company calendar" link in their own account settings. They tap it, and your published schedule flows into their Google Calendar automatically — updating whenever you publish.
{% endhint %}

### Financial

Set your base currency and hourly rates by rank.

Prima calculates **extras pay and overtime automatically on every publish** — no manual math. \
\
Note: Union rule calculations are in Beta and need to be implemented by Prima on a per company basis. \
\
The default currency is USD, but you can change it anytime, and there's a currency selector so you can work in the currency that fits your company.

### Staff Permissions

Decide exactly what each staff role can see and do.

**Set permissions by staff type** — Use the top section to control permissions for an entire role at once. Rehearsal directors, costume department, dancers, and every other role each get their own default set of permissions.

**Grant individual permissions** — Need one dancer to manage shoe inventory, or a single rehearsal director to handle scheduling? Use the bottom section to grant admin permissions to specific people without changing the defaults for their whole role. Staff with admin permissions will need to log in using the web app (any browser) to use admin functions, with the exception of Shoe Management.

{% hint style="info" %}
**What your team sees:** Permissions control exactly what appears in each person's navigation and what they can edit. If you give a dancer write access to Shoe Management, that section simply appears in their app. If you don't, they never see it. This keeps everyone's experience focused on what's relevant to them.
{% endhint %}

***

## Staff

Every member of your company lives here — dancers, rehearsal directors, pianists, physio and treatment staff, costume department, admins, and anyone else.

Each person you add receives an **invite to set up their own Prima account**. From there, they log in and see everything relevant to their role, both on the web and in the Prima app on their phone.

### Adding staff

**Quick Add** lets you add several staff members at once, whatever their roles. Account setup invites go out automatically as you add people.

### Dancers

Open your full dancer roster to see everyone in one view.

* **Filter** by rank or status (Active, Sick/Injured, Away), or search by name
* **Resend** setup emails to anyone who hasn't finished creating their account
* **Update** basic info directly, or open a dancer's **full profile** for visa details, costume measurements, shoe specs, and CV

### Archiving

When a dancer leaves your company, you can archive them. All their data is safely stored in case they return — and when you unarchive them, they're right back on your active roster with all their old data intact.

{% hint style="info" %}
**What your team sees:** When a staff member accepts their invite, they set their own password and complete their profile. Dancers can maintain parts of their own profile — Bios, media, shoe specs, etc. Anything they update saves to their profile, which is accessible to you with the most recent updates.
{% endhint %}

***

## Productions

This is where you create and manage your productions, build casts, and publish them for your staff.

### Active Productions

Your active productions live here. When you're finished with a production, **archive it** — and when you bring it back later, its casts and assigned staff are still intact, ready to go.

### Production details

Every production keeps its own cast, choreographers, rehearsal directors, accompanists, and assigned locations.

**Sections** — Add sections like "Act I", "Act II", or "Pas de trois" to a production. This saves real time when scheduling: instead of scheduling a general "rehearsal" with roles in the notes, you can schedule the "Pas de trois" specifically, select a cast or casts, and Prima knows exactly who to notify.

**View Weekly Schedule** — Jump straight from a production to the current week in the Schedule Editor, automatically filtered to show only that production.

### Building and publishing casts

Each cast is built out by role and cast column (Cast A, Cast B, and so on). When editing, you can rearrange columns, rows, and individual dancer names however you like.

**Publish** the cast when it's ready. The moment you do, your dancers are notified and see their assignments on the Prima app. When you need a hardcopy, a cleanly formatted print version is ready to go.

### Class

Class is set up by default — you don't need to create it. Just assign the rehearsal directors who teach and the accompanists who play, and you're set.

{% hint style="info" %}
**What your team sees:** Dancers see published casts on their phones the instant you publish. Until you publish, casts stay private to you — so you can build and rearrange freely without anyone seeing work in progress. Once live, each dancer knows exactly which roles and casts they're part of, and are immediately updated on changes.
{% endhint %}

***

## Schedule Editor

This is where you'll do most of your day-to-day work. The Schedule Editor is your workspace for building rehearsals, classes, performances, fittings, and every other kind of block.

### Views

Prima gives you four views:

* **Month and year** — the big picture of performances and onstage events across your whole season
* **Day and week** — detailed working views showing every rehearsal, performance, fitting, treatment, and custom block

Switch between them freely depending on whether you're planning the season or working out tomorrow's details.

### Schedule blocks

Every block carries its own production, location, time, and cast. Click any block to view its details or make changes.

**Quick Cast View** — From any block, quickly view the cast for that specific block or the production as a whole, and print either one right from there.

In the Cast Quickview, **called casts appear in bold** and **conflicts show up in red** (more on conflict detection below).

### Publishing

When your changes are ready, hit **Publish**. Every affected dancer and staff member instantly gets a push notification on the Prima app telling them exactly what changed — new blocks, time changes, cancellations, and more.

{% hint style="info" %}
**What your team sees:** Your team only ever sees the *published* schedule — never your drafts. When you publish, they get a notification covering only what changed for them, not every block again. They can view the full company schedule anytime, filter it to their own rehearsals and shows, and tap "Cast" on any block to see who else is in the studio.
{% endhint %}

### Requests

Rehearsal directors send rehearsal requests straight from the Prima app, and they land here for your review. Your costume department and shoe manager can submit requests the same way.

Every request stays put until you resolve it — so nothing gets lost, and there's no chasing notes or back-and-forth trips for you or your staff.

### Best practice: call every cast

When scheduling a rehearsal, call every cast you actually want in the room — even if you're only working one cast that day. This gives you three things:

1. You always know exactly who's expected and who's missing
2. Conflict detection can do its job across your full roster
3. If you have union rules enabled, overtime calculates correctly for everyone called

You can always **mute** a conflicted dancer or an entire cast to acknowledge a conflict without removing them, or turn off conflict detection altogether. Muted or not, called casts still count toward hours worked.

***

## Conflict Detection

Prima watches your schedule in real time and flags conflicts before they become problems — the same dancer called to two places at once, for example.

Here's how it works in practice:

1. When you create or edit a block, Prima checks every called dancer against the rest of the schedule
2. If someone is double-booked, an **alert icon** appears on the affected block
3. Click the alert to open the **Cast Quickview**, where conflicted dancers appear in **red**
4. Click a conflicted dancer's name to see their availability across casts
5. If an alternate cast is available, Prima offers a one-click fix (for example, "Replace with Cast C") to resolve the conflict cleanly. Unavailble casts here will also show in red.

Once resolved, the alert clears. When you publish, your staff see a note on the live schedule showing exactly who's stepping in.

***

## Treatment Schedule

Your physio and treatment staff, along with your dancers, manage the treatment schedule themselves — but you always have full control here.

### How it works

**Availability** — Treatment staff set their own availability, which is visible to the whole company.

**Booking** — Dancers book their own slots directly from the Prima app. Once an appointment is booked, it publishes automatically to both the Schedule Editor and the Live Schedule.

**Waitlist** — Dancers can join the waitlist for any taken appointment. When someone cancels, the next dancer in line is notified automatically and given a window to confirm. No wasted slots, and nothing for you to manage manually.

{% hint style="info" %}
**What your team sees:** Dancers open the Treatment tab in the Prima app, see who's available and when, and book a slot themselves. If their preferred time is taken, they join the waitlist — and if it frees up, they get a push notification with a chance to grab it. Everyone can see the waitlist, which makes informal swaps easy to coordinate in person too.
{% endhint %}

***

## Touring

Touring has its own dedicated booking system, fully integrated with the rest of Prima. Everything you book here appears on your staff's Dashboard within the Live Schedule.

### Setting up a tour

**Upcoming tours** — Your next tour sits at the top of the Tours column. Click it to jump straight to its start date in the Tour Schedule Editor.

**Groups** — Group your schedules for staff travelling on different itineraries, so each person sees the plan that applies to them.

**Tour Settings** — Edit your groups and build roommate lists here. Like everything in Prima, they're ready to print.

### Travel information

Travel itineraries, hotel stays, and venues stay visible for the entire tour. Every address links straight to Maps so no one gets lost, and flight details update live so everyone stays on top of changes.

### Publishing tours

Publish tours exactly like your main schedule. Tour cards for hotels, venues, and travel sit right beneath the day and week views for the length of the tour, so no one misses a detail.

{% hint style="info" %}
**What your team sees:** While on tour, dancers and staff see everything they need — hotels, venues, travel times, and their group's itinerary — right in the Prima app, in the same familiar format as the regular schedule. There's nowhere else they need to look.
{% endhint %}

***

## Shoe Management

Your shoe manager — or anyone you've given admin permissions — handles shoe orders, and you keep full control here.

Track every order from request to delivery. Dancers submit orders from the Prima app using their saved shoe specs, so there are no forms, no emails, and no spreadsheets. Every transaction is logged.

{% hint style="info" %}
**What your team sees:** Dancers open the Shoes tab, and because their specs are already saved to their profile, ordering is a couple of taps. They can see the status of each order from request through to delivery.
{% endhint %}

*A complete inventory system is coming to Prima soon.*

***

## Notifications

All of your notifications come together here — one place to stay on top of everything happening across your company.

You'll receive notifications for:

* Status changes when dancers are sick or injured (with doctor's notes attached)
* Rehearsal and costume fitting requests
* Reimbursement submissions
* Anything else that needs your attention

### Sending notifications

You can also send a one-way message to any individual staff member — or your entire company — delivered instantly as a push notification on the Prima app. This is ideal for anything urgent that falls outside a normal schedule publish.

{% hint style="info" %}
**What your team sees:** Dancers and staff receive push notifications on their phones for anything relevant to them — schedule changes, approvals, treatment openings, and direct messages from you. They control their notification preferences in their own account settings.
{% endhint %}

***

## Financial

Your everyday financial tracking lives here — overtime, role extras pay, and reimbursements.\
Payroll and contract information is not stored here.

### Automatic calculations

Extras pay and overtime are calculated automatically, every time you publish, based on the ranks, hourly rates, and union rules you set in Settings. There's nothing to calculate by hand.

### Expense reimbursements

Dancers submit reimbursement requests with receipts attached, ready for you to review, approve, and download. Year-to-date and season totals update instantly as requests come in and get approved.

{% hint style="info" %}
**What your team sees:** Dancers submit reimbursements requests right from the Prima app — snapping a photo of a receipt with their camera or choosing one from their library, filling in the details, and sending it to you. They can track the status of each submission and get notified when it's marked reimbursed.
{% endhint %}

***

## The Prima App (for your team)

Everything you set up as an admin comes together for your staff in the Prima app, available on the web and as a mobile app (iOS and Android).

Depending on their role and the permissions you've set, your team members can:

* **View the full published schedule** — filter to their own calls, see any block's cast, switch between day, week, month, and year
* **Manage their status** — submit sick or injury notices with doctor's notes, request scheduled leave
* **Keep their profile current** — Visa information, shoe specs, CV entries, media and personal details
* **Book treatment** — reserve physio slots and join waitlists
* **Order shoes** — submit orders from their saved specs
* **Submit reimbursements** — with receipts photographed or uploaded
* **Receive notifications** — schedule changes, approvals, and direct messages, pushed instantly to their phone
* **Subscribe to Google Calendar** — if they prefer their schedule there

Rehearsal directors, costume department, and other staff get role-specific abilities too — like submitting rehearsal or fitting requests that land in your Requests queue.

***

## Quick Setup Checklist

Working through Prima for the first time? This order will get you live fastest:

1. **Facilities** — add every studio, stage, and room
2. **Company Settings** — enable your ranks, upload your logo
3. **Scheduling** — set your season windows and default rehearsal duration
4. **Financial** — set currency and hourly rates
5. **Staff Permissions** — review the defaults (they work for most companies)
6. **Staff** — add your staff and send them invites
7. **Productions** — set up your repertoire, assign Class staff, build casts
8. **Schedule Editor** — build your schedule and publish
9. Set up **Touring**, **Treatment**, and **Shoe Management** as you need them

Once your schedule is published, your team is live. Everything from there stays in sync automatically.

***

*Questions? We're always here — <support@theprima.app>*


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://prima-software-co.gitbook.io/primaguide/prima-admin-manual.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
