Project Tracker System Guide

Welcome to the Project Tracker System

The AmbientPixels Project Tracker is a centralized system for monitoring, documenting, and collaborating on all active and archived projects. This guide will help you understand how the system works, how to add new projects, and best practices for maintaining project documentation.

Whether you're adding a new project, updating an existing one, or just exploring what's in development, this guide provides everything you need to effectively use the Project Tracker Dashboard.

Quick Start: To add a new project, create a markdown file in /docs/logs/, then register it in projects.json. See the "How to Add a Project" section below for details.

System Overview

The Project Tracker Dashboard is a dynamic, filterable view powered by a central projects.json file, markdown logs, and a live dashboard UI.

/docs/logs/projects.json — Master index
/docs/logs/[project-name].md — Markdown logs
/docs/project-dashboard.html — Dashboard interface
/js/project-dashboard.js — Loader/renderer script
/css/components.css — Style system

How to Add a Project

Create a log in /docs/logs/[project].md
Convert to HTML (optional)
Add to projects.json
Reload the dashboard to verify

JSON Entry Format

{
  "title": "Nova Memory Dashboard",
  "html": "/docs/logs/nova-memory-dashboard.html",
  "tags": ["AI", "dashboard"],
  "status": "Active",
  "progress": 0.85,
  "lastUpdated": "2025-04-11",
  "latestLog": "Launched full Nova dashboard with modular awareness system."
}

Styling & Behavior

Uses .filter-pill for interactive filters
Grid layout via .grid-row
Progress bar only appears if defined
Status LEDs via emoji markers

Maintenance Tips

Use ISO dates YYYY-MM-DD
Keep tags consistent (no casing mismatches)
Keep logs synced (MD & HTML)
Short and clear latestLog notes

Future Ideas

Sidebar filter layout
Search by title/log content
Status tabs (Active, Paused, etc.)
Animated progress/status

Last synced by Nova: 2025-04-12