# Finding your way around the app

> The top bar, the command palette, Studio and its tabs, the Create dialog, notifications and the What's New page, and where each one takes you.

- Plans: All plans
- Canonical: https://docs.devlin.ai/get-started/find-your-way-around

Inside the app, devlin.ai keeps its navigation in a bar across the top of every page. This page explains what is in that bar, how to jump anywhere with the command palette, how Studio is laid out and what its **Create** button offers, what the notification bell tells you, and where to read what has changed in the product.

## The top bar
The top bar stays in place while a page scrolls. From left to right it holds:

- The devlin.ai logo. Selecting it takes you to **Studio**.
- The workspace switcher, which shows the active workspace. Studio, Results, Publish and the credit balance all show that workspace. See [Personal and organization workspaces](https://docs.devlin.ai/workspace-and-team/workspaces).
- The destination tabs: **Studio**, **Results** and **Publish**. The tab you are on is highlighted.
- The credit balance of the active workspace, which links to **Settings → Credits & Billing**. It is hidden on phone-width screens.
- The notification bell. See "Notifications" below.
- The account menu, shown as a circle with the first letter of your email address.
- The **Menu** button, a three-line icon at the far right.

On narrower screens the tabs and the workspace switcher move to a strip directly under the top bar, and that strip also stays in place while you scroll. On phone-width screens the account menu is folded into **Menu**.

The top bar is also there while you create a simulation, a coach or an organization, so you can leave those screens through any tab.

While a page loads, the top bar stays where it is and the content area shows a spinner.

### The three destinations
- **Studio** is the library of everything you have built in the active workspace. Unless a link sent you somewhere specific, it is the page you land on after signing in. See "Studio" below.
- **Results** shows what learners did across the workspace. See [The Results dashboard](https://docs.devlin.ai/results-and-analytics/results-dashboard).
- **Publish** has three tabs: **Publish → Overview**, **Publish → Hosting** and **Publish → SCORM Wrap**. See [Publish a simulation](https://docs.devlin.ai/publish-and-embed/publish-a-simulation) and [Hosting and SCORM Wrap](https://docs.devlin.ai/publish-and-embed/hosting-and-scorm-wrap).

Settings is not a tab. You reach it from the account menu.

### The account menu
The account menu starts with your email address and, under it, a line that names the active workspace and its plan. It then lists:

- **Plans**, which opens **Settings → Plans**. See [Plans and features](https://docs.devlin.ai/plans-and-billing/plans-and-features).
- A link to **Settings → Credits & Billing**. See [Credits and usage](https://docs.devlin.ai/plans-and-billing/credits-and-usage).
- **Account settings**, which opens **Settings → Account**. See [Your account](https://docs.devlin.ai/workspace-and-team/account-settings).
- **Workspace settings**, which opens **Settings → Workspaces**.
- The theme choice for the app.
- **Sign out**.

### The Menu button
**Menu** holds these items:

- **What's New** opens the in-app list of product changes. See "What's New" below.
- **Docs** opens the devlin.ai documentation in a new browser tab.
- **Homepage** shows the devlin.ai homepage inside the app, with the top bar still in place.
- **Share feedback** opens a form that sends your feedback to devlin.ai.

## The command palette
The command palette is a search box that opens over any page in the app. Press Cmd+K (Ctrl+K on Windows) to open it, and the same keys to close it. It opens only from the keyboard: there is no button for it.

Type in the box, which reads "Search simulations, coaches, actions…". The list has three sections:

- **Actions** are places to go. Each one matches when what you typed appears anywhere in its name. They include **Go to Studio**, **Go to Results**, **Go to Learners**, **Go to Publish**, **Go to Settings**, **Go to Simulations**, **Go to Coaches**, **Go to Evaluators**, **Go to Knowledge**, **Go to Hosting**, **Go to SCORM Wrap**, **Go to Plans**, **Go to Account**, **What's New** and **Create simulation**, which opens the simulation creation screen.
- **Simulations** are the simulations of the active workspace, matched by name. Each row shows the simulation's status, and selecting one opens it in the editor.
- **Coaches** are the coaches of the active workspace, matched by name. Selecting one opens it in the editor.

Things to know:

- Before you type, the palette lists every action, then a few of the newest simulations and coaches.
- Once you type, matching simulations and coaches come first, followed by matching actions. Only the first few matching simulations and the first few matching coaches are listed, so type more of the name to narrow the list.
- The palette does not search evaluators or knowledge bases. Use **Go to Evaluators** or **Go to Knowledge** and look in that Studio tab.
- **Switch workspace…** opens the workspace switcher. So does Cmd+Shift+O (Ctrl+Shift+O on Windows).
- One action depends on the active workspace: **Go to Personal workspace settings** in your personal workspace, **Go to Organization settings** in an organization.
- Use the up and down arrow keys to move through the list and Enter to open the highlighted row. Escape, or a click outside the palette, closes it.
- If nothing matches, the palette says "No results for" followed by what you typed.
- If your simulations and coaches cannot be loaded, the palette says "Couldn't load your simulations and coaches." Select **Retry**. The actions still work in the meantime.

## Studio
**Studio** is the library for the active workspace. Under the heading **Studio**, a row of tabs switches between the kinds of content. There is no combined view: each tab lists one kind.

- **Simulations** opens first. It lists every simulation under **Your Simulations**.
- **Coaches** lists every coach under **Your Coaches**.
- **Evaluators** lists your evaluators, which score work that learners submit. Evaluators are on every plan. See [Evaluators](https://docs.devlin.ai/evaluators/evaluators-scoring-submitted-work).
- **Knowledge** holds your knowledge bases, under **Knowledge Bases**. Knowledge bases are on these plans: Core, Team, Enterprise. On other plans the tab is still there, and it shows an upgrade prompt with a button that opens **Settings → Plans**. See [Knowledge bases](https://docs.devlin.ai/knowledge/knowledge-bases).

Selecting a tab changes the page address, so you can bookmark a tab or share a link to it.

### The Simulations and Coaches tabs
Both tabs work the same way. Each item is a card with its type, its name, a short line about it and its status. Selecting a card opens the item in its editor.

Once a tab has at least one item, it also shows:

- A search box, which matches on the name. For simulations it also matches on the character description, and for coaches on the coach's own name.
- A status filter: **All statuses**, **Published**, **Draft** or **Archived**.
- A sort order: **Newest first**, **Oldest first** or **Name A–Z**.
- A switch between **List view** and **Tile view**. Your choice is remembered in the browser you are using.
- A **New simulation** or **New coach** button beside the heading.

Once the tab has an item, or the workspace has a folder, a row of folders sits above the list. See [Organizing Studio with folders](https://docs.devlin.ai/get-started/organize-studio-with-folders).

An empty tab shows a short introduction and a button instead: **Create simulation** on the Simulations tab, **Create Your First Coach** on the Coaches tab.

### The Create button
**Create**, at the top right of Studio, opens the **Create new** dialog. It asks "What do you want to create?" and offers:

- **Simulation**: "A practice conversation with an AI character."
- **Coach**: "Real-time guidance and debrief conversations."
- **Knowledge base**: "Reference documents the AI grounds its answers in."

What happens next depends on your choice:

- For a simulation, describe who the learner is and what they need to practice under **Explain your simulation**, then select **Generate simulation**. devlin.ai builds the simulation from your description and shows you a preview. A description is required. To skip it, select **Start from scratch**, which creates a blank simulation named "Untitled simulation" and opens it in the editor. See [Create a simulation](https://docs.devlin.ai/simulations/create-a-simulation).
- For a coach, describe what it should help with under **Explain what this coach should help with**, then select **Generate coach**. **Start from scratch** creates a blank coach named "Untitled Coach" and opens it in the editor.
- For a knowledge base, enter a name under **Knowledge base name** and confirm. The knowledge base is created and Studio switches to the **Knowledge** tab, where you add documents. On a plan without knowledge bases, this step shows the upgrade prompt instead.

When you opened the dialog with **Create**, **All types** takes you back to the list of choices. **Cancel** closes the dialog without creating anything. **Browse templates**, on the first step and the knowledge base step, opens the template gallery. See [Start from a template](https://docs.devlin.ai/get-started/start-from-a-template).

The **New simulation** and **New coach** buttons, and the buttons on an empty tab, open the same dialog with the type already chosen. Evaluators are not in the **Create new** dialog: create one with **New evaluator** on the **Evaluators** tab.

Until your personal workspace has a name, opening the app shows a welcome form over Studio, and the **Create new** dialog follows it on the simulation step. See [Sign in and first steps](https://docs.devlin.ai/get-started/sign-in-and-first-steps).

## Notifications
The bell in the top bar collects things that happened in your workspaces while you were doing something else. Notifications are personal: each member gets a copy and reads it separately.

### What creates a notification
- A first evaluated learner session. The first time a learner session in a workspace is evaluated, every member gets a notification that names the simulation and says it "got its first completed learner session." Test sessions do not count, and this happens once for a workspace, not once for each simulation. Selecting it opens **Results**.
- A comment on a review link. Every member is told who commented and on what. A member who posts a comment is not notified about their own comment. Selecting it opens the simulation on its publish stage. See [Review links](https://docs.devlin.ai/publish-and-embed/review-links).
- A change in pass rate. A weekly check compares the workspace's pass rate for the last week with the week before. When the two differ by 10 percentage points or more, and each week has at least 5 scored sessions, every member is told that the pass rate dropped or moved up, with both rates. Selecting it opens **Results**.
- Low credits. Every member is told when the balance falls below one of the workspace's low-credit thresholds, with the credits remaining. Selecting it opens **Settings → Credits & Billing**. See [Credits and usage](https://docs.devlin.ai/plans-and-billing/credits-and-usage).
- Out of credits. When a session, an evaluation or a generation is declined because the workspace cannot pay for it, every member gets "A session was declined: your workspace is out of credits." A workspace that has never had any credit activity does not get this. This is sent at most once in any 24 hours.
- A daily spending cap is close. When a simulation or a coach has used 80% or more of its daily credit limit, the owner and admins of the workspace are told which one and how much. Members are not. Each simulation and each coach sends this at most once in any 24 hours. Selecting it opens the item's publish stage. See [Daily spending caps](https://docs.devlin.ai/plans-and-billing/daily-spending-caps).

### Reading notifications
- A badge on the bell shows how many notifications you have not read, up to a ceiling, after which it shows a plus sign. The count is taken when the app loads and does not update by itself. Open the bell, or reload the page, to see whether anything new has arrived.
- Select the bell to open the list. It shows your most recent notifications, newest first, each with how long ago it happened. Until you have any, it says "No notifications yet." If the list cannot be loaded, it says "Couldn't load notifications." Select **Try again**.
- Opening the list marks the unread notifications shown in it as read and clears the badge. Only the most recent notifications are shown, so if you have more unread ones than that, the older ones stay unread and the badge comes back the next time the app loads.
- Selecting a notification takes you to the page it is about.
- The list is not limited to the active workspace: it includes notifications from every workspace you belong to. A notification opens its page in the workspace that is active, so switch to the workspace it came from first.

Several of these events also send an email. The pages linked above explain who receives it and how to turn it off. The notification in the app is created either way.

## What's New
**What's New** lists what has shipped in devlin.ai: "New features, improvements, and fixes as they ship". Open it from **Menu**, from the **What's New** action in the command palette, or from the link in the page footer.

- Entries are grouped by month, with the newest month and the newest entries first.
- Each entry has a label, its date, a title and usually a sentence or two of detail. The label is **New** for something you could not do before, **Improved** for a change to something that was already there, and **Fixed** for a problem that was corrected.
- An entry about something that has a documentation page also has a **Read the docs** link, which opens that page in a new browser tab.
- The same list is public on the devlin.ai website for people who are not signed in. When you are signed in, that address brings you to the in-app page.

## Related
- [Sign in and first steps](https://docs.devlin.ai/get-started/sign-in-and-first-steps)
- [Organizing Studio with folders](https://docs.devlin.ai/get-started/organize-studio-with-folders)
- [Start from a template](https://docs.devlin.ai/get-started/start-from-a-template)
- [Create a simulation](https://docs.devlin.ai/simulations/create-a-simulation)
- [Personal and organization workspaces](https://docs.devlin.ai/workspace-and-team/workspaces)
- [The Results dashboard](https://docs.devlin.ai/results-and-analytics/results-dashboard)
- [Credits and usage](https://docs.devlin.ai/plans-and-billing/credits-and-usage)
