About SpeciFlow

A privacy-first, client-side tool for browsing and managing Spec-Driven Development artifacts from local projects and GitHub repositories.

← Back to Projects

How It Works

SpeciFlow is a fully static web application that runs entirely in your browser. Choose the mode that works best for you:

Local Projects

Chrome/Edge only • Full read/write access

1

Click "Add Local Project" and select a directory with .specify/specs/ folder

2

Uses File System Access API to read/write files directly from your filesystem

3

Browse, visualize, and edit specs with real-time saving to your local files

Public GitHub Repositories

All browsers • Read-only mode

1

Click "Add GitHub Repo" and paste any public repository URL

2

App fetches specs via GitHub API (no authentication required)

3

Browse and visualize specs on any browser, including mobile

GitHub OAuth + Pull Requests

All browsers • Full edit access with PR workflow

1

Click "Sign in with GitHub" to authenticate securely

2

Access public and private repositories from your account

3

Edit specs directly in browser with beautiful editor

4

Submit pull requests automatically: fork → branch → commit → PR — all in one click!

Privacy & Security

100% Client-Side

All processing happens in your browser. There is no backend server, no database, and no data transmission to external services.

Local Storage Only

Project metadata and directory handles are stored in your browser's IndexedDB. This data never leaves your device and can be cleared at any time.

Direct File Access

Files are read and written directly to your filesystem. No copies are made, no data is cached on servers, and you retain full control over your files.

No Tracking or Analytics

We don't use cookies, analytics, or tracking. Your usage patterns and data remain completely private.

Browser Compatibility

Local Projects (File System Access API)

For local file editing with live sync:

  • ✓ Chrome 86+ (Desktop)
  • ✓ Edge 86+ (Desktop)
  • ✓ Brave (Chromium-based, Desktop)
  • ✗ Firefox (not supported)
  • ✗ Safari (not supported)
  • ✗ Mobile browsers (limited/no support)

GitHub Projects (Read-Only)

For browsing public GitHub repositories:

  • ✓ All modern browsers (Chrome, Firefox, Safari, Edge)
  • ✓ Mobile browsers (iOS Safari, Chrome Mobile, etc.)

Note: When adding a local project, you'll be prompted to grant read/write permissions. Public GitHub projects don't require authentication. Sign in with GitHub to access private repositories and submit pull requests.

Technical Details

  • Built with: Astro, React, TypeScript, TailwindCSS v4
  • Deployment: Static site + Vercel serverless functions for OAuth
  • Data Storage: IndexedDB (browser-local only, stores project metadata)
  • Local File Access: File System Access API (Chrome/Edge, requires read/write permissions)
  • GitHub Integration: GitHub API + OAuth for public and private repositories
  • Authentication: Secure OAuth flow with httpOnly cookies (session tokens never exposed to client)
  • PR Automation: Automatic fork/branch/commit/PR workflow via GitHub API
  • Source Code: Open source on GitHub (MIT License)