The projects data file exports the array of portfolio projects displayed on the Projects page. It is the primary content file you will edit when setting up your portfolio.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/apursley2012/sys.witch-v2/llms.txt
Use this file to discover all available pages before exploring further.
Schema
Each object in the exportedprojects array accepts the following fields:
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Unique kebab-case identifier (e.g. void-tracker) |
title | string | Yes | All-caps project name displayed as the card heading |
description | string | Yes | 1–3 sentence project description |
tags | string[] | Yes | Technology tags rendered as badge pills |
image | string (URL) | Yes | Hero image URL — landscape orientation, ~800px wide recommended |
demoUrl | string | No | Live demo URL — the Demo button is shown only if this field is provided |
sourceUrl | string | No | Repository URL — the Source button is shown only if this field is provided |
readmeUrl | string | No | README or docs URL — the README button is shown only if this field is provided |
bindingNotes | string | No | Short technical caveat rendered in the purple aside block on the project card |
Example Entry
The following is the complete object for the first placeholder project:Placeholder Projects
The template ships with four placeholder entries to demonstrate layout and styling:id | title | Key Tags |
|---|---|---|
void-tracker | VOID TRACKER | React, TypeScript, Tailwind, Zustand |
nexus-dashboard | NEXUS DASHBOARD | Next.js, D3.js, Framer Motion, WebSockets |
spell-checker-cli | SPELL.CHK CLI | Rust, CLI, Regex, Markdown |
alchemy-ui | ALCHEMY UI | React, Storybook, Radix UI, CSS Modules |
Adding Your Projects
- Open
data/projects.js. - Replace or append entries to the exported array — each item must follow the schema above.
- Host your project screenshots somewhere publicly accessible. Unsplash URLs work well for placeholders; swap them for your own images before publishing.
- Set
demoUrl,sourceUrl, andreadmeUrlonly for the links that genuinely apply to a given project — omitting a field hides that button entirely.