Spec-Kit-UI

Spec Kit Dashboard

For Personal use only - this is not not professional-grade coding.

“This project was more about ai coding and ui integration experimenting

is pure ai generated with kilo code and grok ai

pure Amateur code experimenting with python coding

pre alpha

early version of ui , unstable and full of bugs , but useful for test an initial ui preview version. basic features , bugs This release is pure ui test for bugs , pure pre-alpha version not feature complete.

Spec Kit UI

A pure Python Streamlit web UI for Spec Kit, enabling interactive specification, planning, and task generation for specification-driven development.

Setup

1. Navigate to the project directory:

   cd spec-kit-ui
   

2. Install dependencies using uv (recommended for Python projects):

   uv sync
   

Running the UI

Start the Streamlit app:

uv run ui

Or directly:

uv run streamlit run src/app.py

The app will open in your browser at http://localhost:8501.

Usage

• Dashboard: Overview and new project start.
• Spec: Enter project details (name, description, user story, scenarios, requirements) to generate and edit spec.md.
• Plan: Provide technical context (language, dependencies, etc.) to generate plan.md.
• Tasks: Define task categories to generate and track tasks.md with progress checkboxes.

Use session state for workflow persistence across pages. Edit generated Markdown and download as .md files.

Features

• Interactive forms for inputs with enhanced validation (regex for project names, character limits, file size checks).
• Comprehensive error handling with logging for file I/O, template rendering, and UI interactions.
• Jinja2-based template rendering for specs, plans, tasks.
• Editable Markdown previews.
• Download buttons for exports.
• Task progress tracking with metrics and drag-and-drop reordering.
• Collaboration features: user name input, shared notes, and attribution in generated MD.
• Optional file upload for custom templates (displayed in sidebar, with size validation).
• State persistence to JSON for project continuity.

Dependencies

See pyproject.toml for details: Streamlit, Jinja2, Rich.

Testing

Run unit tests with pytest:

uv run pytest tests/

Tests cover core functions (template loading, spec/plan/tasks generation) and app utilities (state saving/loading). Integration tests verify end-to-end functionality.

Limitations

• No AI integration; manual input for content sections.
• Basic template filling; advanced AI generation from description requires extension.
• Local only; persistence via JSON state files.
• Collaboration is basic; for advanced multi-user features, consider database integration.

For full Spec Kit CLI integration, see the original spec-kit-main project.