Skip to content

mytsdrm/boringboard

 
 

Repository files navigation

BoringBoard

Focalboard is one of those rare tools that just makes sense. Simple, clean, and easy to understand. Big love to the original team ❤️

BoringBoard started as a small fork of Focalboard, then slowly evolved into my personal playground for project management. It follows my own workflow, habits, and occasionally my questionable decisions.

The goal isn't to reinvent project management. The goal is to make it a little less painful, a little more practical, and maybe even a little less boring.

That's why it's called BoringBoard.

BoringBoard, another fork of focalboard - BoringBoard, A place for all those "I'll do it later" tasks | Product Hunt

Default Theme BoringBoard

Admin BoringBoard

BoringBoard

Dark Theme BoringBoard

Added Features

  • AI integration: Create task board previews from a command before creating the real board.
  • Available AI providers: OpenAI, Gemini, Ollama, Cline, and Anything LLM.
  • AI model selection: Select provider models from System Settings, including Ollama model loading from the configured endpoint.
  • AI access control: Enable AI for all users or selected users with a searchable multi-user picker designed for large user lists.
  • Centralized admin user: Default SuperAdmin user/group support with configurable admin username and password from .env.
  • User management: Admin-only Users menu with search, group filtering, pagination, add/edit/delete modals, and Tabler-styled tables.
  • Activity logs: Admin activity log view across registered users with search, filters, date range, pagination, and scrollable table area.
  • System Settings: Manage app name, logo upload, timezone, AI provider settings, AI user access, and task board permissions.
  • Realtime settings updates: Branding, logo, favicon, and selected task board permission settings update across active clients.
  • Task board permissions: Configure whether invited users can share task boards or edit task board properties.
  • Task board settings: Board owners can save repository, dev/prod branch, and environment URL details at the task-board level, with a read-only Task Board Info panel in the board header.
  • Profile menu improvements: Top-right user menu with Invite users, Profile, Change password, and Logout modals.
  • Branding updates: Custom app name/logo/favicon support with custom branding loaded first on login and sidebar header to avoid default-logo flashes on slow connections.
  • Table utilities: Reusable table module with search alignment, Options menu, and print/export actions.

How to start

Create an .env file in the BoringBoard directory if it does not already exist:

EXCLUDE_ENTERPRISE="1"
EXTERNAL_PORT="8000"
BORINGBOARD_DEFAULTADMINUSERNAME="admin"
BORINGBOARD_DEFAULTADMINPASSWORD="admin123"
BORINGBOARD_AI_OPENAI_ENDPOINT="https://api.openai.com/v1"
BORINGBOARD_AI_GEMINI_ENDPOINT="https://generativelanguage.googleapis.com/v1beta"
BORINGBOARD_AI_OLLAMA_ENDPOINT="http://localhost:11434"
BORINGBOARD_AI_CLINE_ENDPOINT="https://api.cline.bot/api/v1"
BORINGBOARD_AI_ANYTHINGLLM_ENDPOINT="http://localhost:3001/api/v1"
BORINGBOARD_AI_TIMEOUT="180"

Run the local development script:

./run.sh

Then open:

http://localhost:8000

The script starts the server, builds/watches the web app, clears ports 8000 and 8001 when needed, and enables browser auto-reload for frontend changes.


Original Focalboard README

The content below is kept from the original Focalboard project for upstream reference.

CI Status CodeQL Dev Release Prod Release

BoringBoard

BoringBoard is an open source, multilingual, self-hosted project management tool that's an alternative to Trello, Notion, and Asana.

It helps define, organize, track and manage work across individuals and teams. Focalboard comes in two editions:

Try Focalboard

Personal Desktop (Windows, Mac or Linux Desktop)

Personal Server

Ubuntu: You can download and run the compiled Focalboard Personal Server on Ubuntu by following our latest install guide.

API Docs

Boards API docs can be found over at https://htmlpreview.github.io/?https://github.com/mattermost/focalboard/blob/main/server/swagger/docs/html/index.html

Getting started

Our developer guide has detailed instructions on how to set up your development environment for the Personal Server. You can also join the ~Focalboard community channel to connect with other developers.

Create an .env file in the focalboard directory that contains:

EXCLUDE_ENTERPRISE="1"

To build the server:

make prebuild
make

To run the server:

 ./bin/focalboard-server

Then navigate your browser to http://localhost:8000 to access your Focalboard server. The port is configured in config.json.

Once the server is running, you can rebuild just the web app via make webapp in a separate terminal window. Reload your browser to see the changes.

Building and running production builds

  • Linux server package:
    • Run make prebuild
    • Run make server-linux-package
    • Uncompress dist/focalboard-server-linux-amd64.tar.gz to a directory of your choice.
  • Docker:
    • To run it locally from offical image:
      • docker run -it -p 80:8000 mattermost/focalboard
    • To build it for your current architecture:
      • docker build -f docker/Dockerfile .
    • To build it for a custom architecture (experimental):
      • docker build -f docker/Dockerfile --platform linux/arm64 .

Unit testing

Before checking in commits, run make ci, which includes:

  • Server unit tests: make server-test
  • Web app ESLint: cd webapp; npm run check
  • Web app unit tests: cd webapp; npm run test
  • Web app UI tests: cd webapp; npm run cypress:ci

Staying informed

About

BoringBoard is a personal fork of Focalboard, adapted for my own project management workflow and productivity needs.

Resources

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors

Languages