PMO Prototype Suite

This repository contains a set of lightweight web apps for program management offices. Every app is self‑contained and can be deployed straight to GitHub Pages.

The suite currently includes:

• Integrated Controls Command Board – baseline vs actual cost/schedule, FTE utilisation and efficiency KPIs.
• Decision Latency Tracker – days from first signal to decision closure for changes, risks and approvals.
• Lessons-to-Action Synthesiser – searchable catalogue of lessons with quick copy‑to‑clipboard summaries.
• Organisational Heatmap & Efficiency Tracker – colour‑coded matrix of teams vs processes with utilisation drill‑downs.
• Digital Controls Landscape Diagram – Mermaid diagram showing how all components link together.

Platform Sections

• Home – Welcome & Overview – Introductory page that welcomes users and explains the platform’s mission and structure in general terms.
• Projects Portfolio – Directory of all innovation projects with brief summaries, allowing users to explore and navigate to individual project pages.
• Interactive Tools Sandbox – A playground of lightweight, interactive tools (e.g. control-signal tiles, sandbox workbenches, use case mappers) where teams can prototype and experiment.
• AI Tools & Collaboration – Showcases AI-assisted features for project work – from planning and decision support to assurance and performance measurement – and how they enhance team collaboration.
• Systems Thinking & Stakeholders – Guides users in applying a systems-thinking lens, mapping stakeholder networks and decision processes to handle complexity and reduce decision latency.
• Project Lifecycle & Governance – Provides a generic project lifecycle framework with governance checkpoints, aligning with best-practice methodologies in a flexible, user-friendly way.
• Insights & Learning Hub – Repository of shared knowledge – including lessons learned, case studies, and reference materials – to promote reflection and continuous learning across projects.

Getting Started

1. Install dependencies

   npm install

2. Start the development server

   npm start

By default this serves the portfolio-state-machine template. The server loads the template app at http://localhost:3000. Future apps can be served by setting APP=<app-name>.

3. Run tests

   npm test

   This launches Vitest in watch mode.

4. Create a production build

   npm run build

   The build script iterates over every folder in apps/ and writes the optimised output under docs/apps/<app-name>.

5. Preview the production build locally

   npm run preview

   Pass APP=<app-name> to preview a specific build.

Project Structure

• apps/<app-name>/ – individual applications with their own src and index.html.
• src/common/ – shared utilities like index.css, reportWebVitals.js and test setup.
• vite.config.js – uses the APP environment variable to select which app to serve or build.
• scripts/build-all.js – builds every app found in apps/.

Adding a New App

1. Create apps/<app-name>/ with a src folder and index.html. Include <a href="../../index.html">Back to app index</a> in the HTML.
2. Add a screenshot as pics/<number>.png and a row to app-index.csv with the same number in the # column.
3. Run and test locally with APP=<app-name> npm start and npm test.
4. Build with npm run build when ready.

Design & Style Guidelines

• Use the shared common.css stylesheet with a relative path in every static app.
• common.css imports the Inter font and defines base spacing, heading rules and .btn classes.
• Include a viewport meta tag and design layouts responsively.
• Keep asset paths relative (avoid leading /). React apps should set basename={import.meta.env.BASE_URL} on the router.
• Embed small datasets inline so pages open without a server.

Deploying to GitHub Pages

Push your changes to the main branch and enable GitHub Pages in the repo settings using Deploy from branch with the root folder. Each app folder then becomes available at:

https://<org>.github.io/<repo>/<app-folder>/

Learn More

• Vite documentation
• Vitest documentation
• React documentation

License

This project is licensed under the MIT License.