Guideed.ai

Guideed.ai is a "Safe-to-Fail" school governance platform designed to empower parents and improve school transparency through data-driven feedback and interactive incident management.

🚀 Key Features

• Parent Support Dashboard: A central hub for active support and situational awareness.
• Interactive Incident Management: Visualizes the escalation ladder from Teacher to Board.
• Survey Feedback Module: Synthesizes parent feedback into Board-aligned objectives.
• Admin Portal: Comprehensive analytics and reporting for school administrators.
• Human-in-the-Loop Email Workflows: Draft-first email integration for sensitive communications.

🛠️ Tech Stack

• Framework: Next.js (App Router)
• Database/Auth: Supabase
• Styling: Tailwind CSS
• Animations: Framer Motion

📦 Getting Started

Prerequisites

• Node.js 20+
• npm

Installation

1. Clone the repository:

   git clone https://github.com/NathanWCarlson/guideed.ai.git

2. Install dependencies:

   npm install

3. Set up environment variables: Copy .env.local.example to .env.local and fill in your Supabase and OpenAI credentials.

4. Run the development server:

   npm run dev

🏗️ CI/CD

This project uses GitHub Actions for Continuous Integration. The workflow is defined in .github/workflows/ci.yml and runs on every push to the main branch.

Current Status: ✅ First successful build achieved!

The CI pipeline includes:

• ESLint code quality checks
• TypeScript compilation
• Next.js production build
• Environment variable validation

Next Steps (PI-9):

• Production deployment to Vercel
• Automated testing integration
• Preview deployments for PRs

📜 Documentation

• Product Requirements Document (PRD)
• Product Roadmap
• Deployment Guide
• Email Setup Guide
• Implementation Summary
• Workspace Maintenance Skill

🎯 Current Focus (PI-9)

Program Increment 9 (Feb 6-20, 2026) focuses on:

1. 🚀 Production Deployment (Vercel)
2. 🗄️ Database Migrations & Schema Management
3. 🎯 Core Feature Completion
4. 🧪 Testing Infrastructure
5. 🛠️ Developer Experience Improvements

See docs/ROADMAP.md for detailed planning.

---

Created by Antigravity AI