scriptoriumadmin/veritas-kanban
1
0
Fork 0
mirror of https://github.com/BradGroux/veritas-kanban.git synced 2026-08-28 02:44:59 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 1
No description
1 commit 103 branches 50 tags 106 MiB
Find a file
Brad Groux a489c5358f feat: initial project scaffolding 
- Dev container with Node.js 22
- pnpm workspace monorepo structure
- Express + WebSocket server
- React + Vite + shadcn/ui frontend
- Shared TypeScript types package
- Kanban board with drag-and-drop
- Task CRUD with file-based persistence
- Dark mode styling

Sprint 1 - US-101: Project scaffolding with dev container
2026-01-26 02:34:54 -06:00
.devcontainer feat: initial project scaffolding 2026-01-26 02:34:54 -06:00
.veritas-kanban feat: initial project scaffolding 2026-01-26 02:34:54 -06:00
server feat: initial project scaffolding 2026-01-26 02:34:54 -06:00
shared feat: initial project scaffolding 2026-01-26 02:34:54 -06:00
tasks feat: initial project scaffolding 2026-01-26 02:34:54 -06:00
web feat: initial project scaffolding 2026-01-26 02:34:54 -06:00
.gitignore feat: initial project scaffolding 2026-01-26 02:34:54 -06:00
.prettierrc feat: initial project scaffolding 2026-01-26 02:34:54 -06:00
package.json feat: initial project scaffolding 2026-01-26 02:34:54 -06:00
pnpm-workspace.yaml feat: initial project scaffolding 2026-01-26 02:34:54 -06:00
README.md feat: initial project scaffolding 2026-01-26 02:34:54 -06:00

README.md

Veritas Kanban

A local-first task management and AI agent orchestration platform built for Brad Groux and Veritas.

Features

  • 📋 Kanban Board - Visual task management with drag-and-drop
  • 🤖 AI Agent Orchestration - Spawn Claude Code, Amp, Copilot, Gemini
  • 🌳 Git Worktrees - Isolated branches for each coding task
  • 📝 Markdown Storage - Human-readable task files with frontmatter
  • 🔍 Code Review - Diff viewing and inline comments
  • 🌙 Dark Mode - Easy on the eyes

Quick Start

# Clone the repo
git clone https://github.com/dm-bradgroux/veritas-kanban.git
cd veritas-kanban

# Install dependencies
pnpm install

# Start development
pnpm dev

Open http://localhost:3000 in your browser.

Tech Stack

Layer Technology
Runtime Node.js 22+
Language TypeScript (strict)
Server Express + WebSocket
Frontend React 19 + Vite + shadcn/ui
Persistence Markdown files (gray-matter)
Git simple-git

Project Structure

veritas-kanban/
├── .devcontainer/     # Dev container config
├── server/            # Express API + WebSocket
├── web/               # React frontend
├── shared/            # Shared TypeScript types
├── tasks/             # Task storage (markdown files)
│   ├── active/        # Current tasks
│   └── archive/       # Completed tasks
└── .veritas-kanban/   # Config and runtime data

Repositories

Development

Prerequisites

  • Node.js 22+
  • pnpm 9+

Commands

pnpm dev        # Start dev server (frontend + backend)
pnpm build      # Build for production
pnpm typecheck  # Run TypeScript checks
pnpm lint       # Run ESLint

Dev Container

This project includes a VS Code Dev Container configuration. Open in VS Code and select "Reopen in Container" for a consistent development environment.

Task File Format

Tasks are stored as markdown files with YAML frontmatter:

---
id: "task_20260126_abc123"
title: "Implement feature X"
type: "code"
status: "in-progress"
priority: "high"
project: "rubicon"
---

## Description

Details about the task...

License

MIT