Skip to content
CK/SYSTEMS
Back to Macquarie College
live fullstack

πŸ“– Interactive Guides

Step-by-step wizards for device setup and service configuration

Role

Lead Developer

Timeframe

2024 - Present

Stack

Next.js React TypeScript pdf-lib Tailwind CSS

Overview

Step-by-step wizards that walk staff and students through device and service setup β€” primarily printer configuration for Windows and Mac. Each guide presents platform-specific instructions with visual aids, reducing the need for ICT staff to handle routine setup requests in person.

Key Features

  • Platform-specific guides β€” Separate step sequences for Windows and Mac printing setup, with OS-appropriate screenshots and instructions
  • Accessibility tested β€” Validated with Axe for WCAG compliance so guides are usable by all staff and students
  • PDF generation β€” Exportable guide summaries via pdf-lib for offline reference
  • CSV data parsing β€” PapaParse integration for guides that involve bulk device configuration data
  • Shared wizard components β€” The mc-interactive-components package provides reusable step, wizard, and navigation primitives consumed by this app

Design Decisions

  • Wizards over static docs: Printer setup branches based on user choices β€” Windows vs Mac, network vs USB, specific printer model. A static doc would need a separate article for every permutation, or a long page with β€œskip to section X” instructions. A wizard conditionally shows only the relevant steps based on earlier selections, which is a fundamentally different UX from scrolling a document.
  • WCAG / Axe testing: NSW public schools fall under the Disability Discrimination Act and NSW Government digital accessibility requirements. Since these guides are used by every staff member and student, accessibility isn’t optional β€” Axe validation ensures compliance and catches regressions before deployment.

Demo

Interactive guide walkthrough: step-by-step device setup with visual instructions.

Outcomes

  • Self-service device setup without ICT intervention
  • Reduced support tickets for common configurations

Need a workflow like this shipped properly?

Send the workflow, bottleneck, or delivery problem. I will tell you whether it fits a governed workflow audit, starter build, or implementation sprint.

Request consulting
Newsletter

Short notes on building AI agents in production.

One email when something worth sharing ships. No fluff, no daily cadence, no recycled growth-thread noise.

Primary use: consulting updates, governed AI workflow lessons, and major project writeups.