Skip to content

cdevroe/signboard

Repository files navigation

Signboard

A local-first kanban-style desktop app built with a web stack. Signboard stores your lists as directories and cards as Markdown files on disk, so you own your data. Built with as few dependencies as possible 😅, it’s lightweight, transparent, and open source.

License: MIT GitHub issues GitHub pull requests Donate


✨ Highlights

  • 📂 Cards saved as Markdown files (portable & future-proof)
  • 🖥 Runs as a desktop app
  • 🪶 Minimal dependencies, just plain JavaScript + Electron

🚀 Installation

  1. Go to the Releases page.
  2. On the latest releae, download the installer for your operating system:
    • Windows: .exe
    • macOS: .dmg
    • Linux: .AppImage (coming soon?)

🛠 Development

# Clone the repo
git clone https://github.com/cdevroe/signboard.git
cd signboard

# Install dependencies
npm install

# Concatenate JavaScript files
./buildjs.sh

# Run the app in dev mode
npm start

🤝 Contributing

Contributions in all forms are welcome!

  • Report bugs: Open an Issue.
  • Suggest features: Open an Issue with the enhancement label.
  • Submit fixes or features: Fork the repo, make your changes, and open a Pull Request.

Contribution Guidelines

  • Keep PRs focused: one change per PR makes reviews faster.
  • Follow existing code style where possible (or, please, suggest new code styles)
  • Be respectful and constructive in discussions.

💖 Support the Project

If you find Signboard useful and want to support development, you can donate here:

👉 https://cdevroe.com/donate

Thank you!


📜 License

MIT © 2025 Colin Devroe - cdevroe.com

Third-Party Notices

My thanks to John Gruber for creating Markdown and to Steph Ango, CEO of Obsidian, for his File over app philosophy.

Signboard includes static versions the following open source libraries:

About

A local-first kanban app that writes Markdown files.

Resources

License

Stars

Watchers

Forks

Packages

No packages published