Skip to main content

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.

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.

Schema

Each object in the exported projects array accepts the following fields:
FieldTypeRequiredDescription
idstringYesUnique kebab-case identifier (e.g. void-tracker)
titlestringYesAll-caps project name displayed as the card heading
descriptionstringYes1–3 sentence project description
tagsstring[]YesTechnology tags rendered as badge pills
imagestring (URL)YesHero image URL — landscape orientation, ~800px wide recommended
demoUrlstringNoLive demo URL — the Demo button is shown only if this field is provided
sourceUrlstringNoRepository URL — the Source button is shown only if this field is provided
readmeUrlstringNoREADME or docs URL — the README button is shown only if this field is provided
bindingNotesstringNoShort 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:
{
  id: 'void-tracker',
  title: 'VOID TRACKER',
  description:
    'A dark-mode first task management system utilizing local storage and a custom drag-and-drop interface. Built to organize chaos into structured data.',
  tags: ['React', 'TypeScript', 'Tailwind', 'Zustand'],
  image: 'https://images.unsplash.com/photo-1555949963-aa79dcee981c?auto=format&fit=crop&q=80&w=800',
  demoUrl: '#',
  sourceUrl: '#',
  bindingNotes: 'Data persists locally. No external database summoned.',
}

Placeholder Projects

The template ships with four placeholder entries to demonstrate layout and styling:
idtitleKey Tags
void-trackerVOID TRACKERReact, TypeScript, Tailwind, Zustand
nexus-dashboardNEXUS DASHBOARDNext.js, D3.js, Framer Motion, WebSockets
spell-checker-cliSPELL.CHK CLIRust, CLI, Regex, Markdown
alchemy-uiALCHEMY UIReact, Storybook, Radix UI, CSS Modules

Adding Your Projects

  1. Open data/projects.js.
  2. Replace or append entries to the exported array — each item must follow the schema above.
  3. Host your project screenshots somewhere publicly accessible. Unsplash URLs work well for placeholders; swap them for your own images before publishing.
  4. Set demoUrl, sourceUrl, and readmeUrl only for the links that genuinely apply to a given project — omitting a field hides that button entirely.
Use an all-caps title to match the project convention (VOID TRACKER, NEXUS DASHBOARD). Sentence-case in the description is fine.

Build docs developers (and LLMs) love