PitchHut logo
A local-first, git-native task board managed in Markdown files.
Pitch

boardown is a unique task board that integrates directly with your Git repository, allowing tasks, epics, and releases to be stored as plain Markdown files. With a fully-featured VS Code extension and a standalone desktop app, it empowers developers to manage their projects without relying on cloud services or accounts.

Description

boardown is a local-first, git-native task board that leverages Markdown for storing data within your project's Git repository. This innovative tool allows releases, epics, and tasks to reside as plain Markdown files in the .boardown/ directory, maintaining version control, branching, and diff capabilities alongside your codebase—without relying on cloud services, external servers, or user accounts.

Key Features

  • Local-first Architecture: All data is stored locally in Markdown files, ensuring privacy and control over your project tasks.
  • Cross-Platform Accessibility: Use boardown as a VS Code extension or as a standalone desktop application compatible with Windows, macOS, and Linux. Both versions provide a consistent user interface and functionality, reading and writing from the same Markdown files.
  • Command-Line Interface: A headless CLI (@grinev/boardown-cli) is available for automation, enabling scripts and AI agents to interact with the task board via the command line.

User Interface

The boardown task board features a clear and intuitive UI, allowing users to manage tasks effortlessly. Here’s what you can expect:

boardown board view

boardown task details

boardown backlog view

Supported Workflows

Incorporate boardown seamlessly into your development workflow by choosing from three modes of interaction:

  1. VS Code Extension: Integrate boardown directly into your development environment for a streamlined experience. Install through the VS Code Marketplace or Open VSX, and access features effortlessly via the command palette or board icon.

  2. Desktop Application: Launch the Electron-based desktop app to work with tasks outside of an IDE while still maintaining access to the same functionality and data.

  3. CLI Tool: The command-line interface allows developers to run scripts and automate interactions with the task board, making it powerful for continuous integration and delivery workflows.

Conclusion

boardown provides an effective solution for teams and individuals seeking a self-contained task management system. By encapsulating the task lifecycle in Markdown, it enhances transparency, facilitates collaboration through Git's versioning, and favors a local-first approach that prioritizes user autonomy.

For full specifications of boardown, visit PRODUCT.md and explore the project’s roadmap in .boardown/.

0 comments

No comments yet.

Sign in to be the first to comment.