Skip to content

Job application tracker and AI-powered job search assistant. Helps job seekers manage their search journey with AI resume review, job matching, task logging, and application analytics, all while keeping your data private.

docs(interviews): add the Interviews help page and cross-links, an end-to-end spec, and repoint the fixture's Add Job selector

Khuram Niaz2b7082accd8f
diff --git a/e2e/fixtures.ts b/e2e/fixtures.ts
index 3f3a36c..f8f9736 100644
--- a/e2e/fixtures.ts
+++ b/e2e/fixtures.ts
@@ -84,10 +84,10 @@ export async function createNewJob(
const locationText = options?.location ?? `location ${suffix}`;
// Matches either entry point: the dashboard quick-action card (labeled
- // "Job") when starting from /dashboard, or the myjobs page's own inline
+ // "Add Job") when starting from /dashboard, or the myjobs page's own inline
// trigger (labeled "New Job", from AddJob.tsx) when already on
// /dashboard/myjobs — createNewJob is called from both contexts.
- await page.getByRole("button", { name: /^(New )?Job$/ }).click();
+ await page.getByRole("button", { name: /^(New |Add )?Job$/ }).click();
await expect(page).toHaveURL(/\/dashboard\/myjobs/);
// Dashboard's "Job" button auto-opens the dialog via ?add-job=true.
await expect(page.getByTestId("add-job-dialog-title")).toBeVisible();
diff --git a/e2e/interviews.spec.ts b/e2e/interviews.spec.ts
new file mode 100644
index 0000000..a0d646b
--- /dev/null
+++ b/e2e/interviews.spec.ts
@@ -0,0 +1,46 @@
+import { test, expect, createNewJob, uniqueName } from "./fixtures";
+
+test("an interview stage added on a job appears on the Interviews page", async ({
+ page,
+ cleanup,
+}) => {
+ const jobTitle = uniqueName("Interview Engineer");
+ const jobId = await createNewJob(page, jobTitle, cleanup);
+
+ // The round is created where rounds are created: the job's Timeline tab.
+ await page.goto(`/dashboard/myjobs/${jobId}?tab=timeline`);
+ await page.getByTestId("timeline-add-stage-btn").click();
+ await page.getByTestId("stage-type-select").click();
+ const search = page.getByPlaceholder("Search stage");
+ await search.fill("Final / Onsite Interview");
+ await page
+ .getByRole("option", { name: "Final / Onsite Interview", exact: true })
+ .click();
+ await expect(search).not.toBeVisible();
+ await page.getByRole("button", { name: "Add Stage", exact: true }).click();
+ await expect(page.getByRole("tab", { name: /Timeline/ })).toContainText("2");
+
+ await page.goto("/dashboard/interviews");
+
+ // The Add Stage dialog dated the round a moment ago, so Past holds it and
+ // the default Upcoming view does not. Switch before asserting anything.
+ await page.getByRole("tab", { name: "Past" }).click();
+
+ const row = page.getByRole("row", { name: new RegExp(jobTitle) });
+ await expect(row).toBeVisible();
+ await expect(row).toContainText("Final / Onsite Interview");
+
+ // Expanding shows the prep-question panel for the round.
+ await page
+ .getByRole("button", { name: new RegExp(`Expand ${jobTitle}`) })
+ .click();
+ await expect(page.getByText(/Prep questions/)).toBeVisible();
+
+ // The round menu records an outcome, and the badge follows.
+ await row.getByRole("button", { name: "Toggle menu" }).click();
+ await page.getByRole("menuitem", { name: "Set outcome" }).click();
+ await page.getByRole("menuitem", { name: "Passed", exact: true }).click();
+ await expect(
+ page.getByRole("row", { name: new RegExp(jobTitle) }),
+ ).toContainText("Passed");
+});
diff --git a/src/lib/wiki/schema.ts b/src/lib/wiki/schema.ts
index 4ca8066..bd2259f 100644
--- a/src/lib/wiki/schema.ts
+++ b/src/lib/wiki/schema.ts
@@ -14,6 +14,7 @@ export const WIKI_FEATURES = [
"setup",
"jobs",
"timeline",
+ "interviews",
"contacts",
"companies",
"automations",
diff --git a/wiki/index.md b/wiki/index.md
index d831666..518571b 100644
--- a/wiki/index.md
+++ b/wiki/index.md
@@ -9,6 +9,7 @@ JobSync tracks job applications, resumes and the work you do around them. These
- [Getting Started](./getting-started.md) — create an account, connect an AI provider, add your first job, and what each area of the app is for.
- [Jobs](./jobs.md) — add jobs manually or by pasting a posting into AI chat, move them through the status workflow, edit, filter, export and delete them.
- [Job Timeline](./timeline.md) — record each stage of a hiring process with its date, link the interviewers, and build a prep list of the questions you expect.
+- [Interviews](./interviews.md) — every interview round across your jobs in one list, with upcoming and past views, filters and outcomes.
- [Contacts](./contacts.md) — track recruiters, interviewers and references, link them to the jobs they touched, and record how you know them.
- [Companies](./companies.md) — a company's details page with its jobs and contacts, watching a company, and why a company can't be deleted.
- [Automations](./automations.md) — set up a scheduled search over Greenhouse, Lever and Ashby company boards, fill in the filters that make it work, and handle the jobs it discovers.
diff --git a/wiki/interviews.md b/wiki/interviews.md
new file mode 100644
index 0000000..74b2f38
--- /dev/null
+++ b/wiki/interviews.md
@@ -0,0 +1,44 @@
+---
+type: how-to
+title: Interviews
+description: One list of every interview round across all your jobs — what is coming up, what is behind you, who you are meeting and what you planned to be asked.
+feature: interviews
+tags: [interviews, interview list, upcoming interviews, past interviews, rounds, outcome, scheduled, prep questions, interviewers, format, screening, onsite]
+aliases: [interview list, upcoming interviews, my interviews]
+status: stable
+stale_after: 2027-09-30
+---
+
+# Interviews
+
+## What does the Interviews page show?
+
+**Interviews** in the sidebar lists every interview round you have recorded, across every job, in one table. A round appears here as soon as you add a stage whose parent status is *Interview* on a job's [Timeline](./timeline.md) tab — there is nothing extra to fill in. Rounds on jobs that were rejected or withdrawn stay in the list, because the history is the point.
+
+Each row shows when the round is, the job and company, which round it is, the format and duration, who is interviewing you, how many prep questions the round has, and its outcome.
+
+## How do I switch between upcoming and past interviews?
+
+Use the **Upcoming**, **Past** and **All** buttons in the page header. **Upcoming** is where the page opens: it holds every round dated from now on, plus any round you have not put a date on yet — an unscheduled round is still work ahead of you, so it sits at the top rather than out of sight. **Past** holds rounds whose date has gone, most recent first. **All** shows everything, newest first, with unscheduled rounds at the top.
+
+## How do I find one interview among many?
+
+Three controls sit beside the view buttons. **All rounds** narrows to one kind of round — *1st Screening Interview*, *Final / Onsite Interview*, or any round name of your own. **All companies** narrows to one company. Both only offer rounds and companies you actually have interviews for, so a choice never gives you an empty table. The **search** box matches the job title, the company, the round name and the interviewers' names, so you can find "everyone I spoke to at Northwind" by typing a name.
+
+## What does the Outcome column mean?
+
+Outcome is the result you recorded: *Scheduled*, *Completed*, *Passed*, *Failed*, *No-show* or *Cancelled*. Until you record one, the page works it out from the date — a round still ahead reads **Scheduled**, a round whose date has gone reads **Awaiting outcome**, and a round with no date reads **Not scheduled**. Those three are descriptions, not saved values; recording a real outcome replaces them.
+
+To record one, open the **⋮** menu at the end of a row and choose **Set outcome**. Once a round has an outcome, the same menu offers **Clear outcome**.
+
+## What is in the expanded row?
+
+Click the arrow at the start of a row to open it. The panel shows the full interviewer list with their titles and email addresses, your notes for the round, and the prep questions with a tick against the ones already asked. One row is open at a time — opening another closes the first.
+
+Everything in the panel is read-only. Linking an interviewer, building a prep list and ticking a question as asked all happen on the job's [Timeline](./timeline.md) tab, where those tools live.
+
+## How do I change an interview from this page?
+
+The **⋮** menu at the end of a row has **Edit round**, which opens the same dialog as the Timeline tab — date, time, format, duration, location, notes and outcome — and saves in place. **Open job timeline** takes you to that job's Timeline tab for anything else: adding another round, linking interviewers, building the prep list or deleting a round.
+
+New rounds are always added from a job's Timeline tab. This page reads and edits; it does not create.
diff --git a/wiki/timeline.md b/wiki/timeline.md
index 7490cde..d535588 100644
--- a/wiki/timeline.md
+++ b/wiki/timeline.md
@@ -87,7 +87,7 @@ Because the stage they would act on is not an interview stage. Both items are ga
The menu tells you which stage it is targeting and why: it reads **"Applied is not an interview stage"** when the selected stage is not one, and **"Add a stage first"** when the job has no stages at all. Both items act on the stage you have selected on the Timeline tab, falling back to the current stage, so select the interview stage first.
-A stage counts as an interview stage when its parent status is *Interview*. That is true of the three seeded interview rounds, and of any custom stage type you created under the Interview status.
+A stage counts as an interview stage when its parent status is *Interview* — the three seeded rounds, or any type you created under it. Those stages are also what the [Interviews](./interviews.md) page lists.
## Can I rename or add my own stages?