VeryBoard Application Documentation

1. Introduction

What is VeryBoard?

VeryBoard is a modern, single-user Kanban board application designed to help you structure your work and manage priorities. It runs entirely in your web browser and is built for personal organization, not real-time collaboration.

Your Data is Your Own

A core principle of VeryBoard is data privacy and user control.

• No Servers, No Accounts: The application does not require an account or login.

• Local-Only Storage: All your board and card data is saved only when you explicitly choose to save it. This data is stored as files on your local device.

• No Data Transmission: Your board information is never sent to or stored on any external server.
  
  

In other words, it is perfect for project management with a sensitive nature.

2. The Kanban Board

The main interface is a classic Kanban board, allowing you to visualize your workflow.

Lanes

The board is divided into six distinct lanes:

• Idea: For new tasks and brainstorming.

• To do: For prioritized tasks ready to be started.

• Ongoing: For tasks you are currently working on.

• Approve: For tasks that are complete and pending review.

• Done: For completed tasks.

• Rejected: For tasks that have been cancelled or rejected.

Drag & Drop

You can move any card between lanes by simply clicking and dragging it to a new list. This is the primary way to update a task's status.

3. Working with Cards

Cards represent individual tasks, stories, or epics.

Creating & Editing

• Create: Click the "New Card" button at the bottom of any lane to create a new card in that lane.

• Edit: Double-click any existing card on the board to open the editor modal.

The Card Editor

When you create or edit a card, a detailed modal appears with the following fields:

• Title: The main title of the card.

• Brief Description: A short summary of the task.

• Comment: A rich-text editor for detailed notes, checklists, or comments. You can use the toolbar to:

  • Make text Bold or Italic.

  • Create an unordered (bullet) list.

  • Align text (Left, Center, Right, Justify).

  • Change font size.

  • Create a hyperlink.

• Card Category: Define the card's type:

  • Epic: A large body of work (can be linked to Stories).

  • Story: A user story or feature (can be linked to Epics or Tasks).

  • Task: The smallest unit of work (can be linked to Stories).

• Linked Cards: Based on the selected category, this dropdown allows you to link the current card to related cards (e.g., link a 'Task' to its parent 'Story').

• Owner (email): Assign an owner using their email address. This is used for the "Send Reminder" feature.

• Due Date: A calendar to set a deadline.

• Days before due: Set the number of days before the due date to trigger a reminder.

• Card Color & Text Color: Customize the card's appearance for visual organization.

• Delete Button: (Visible when editing) Permanently deletes the card from the board.

Automatic Work Tracking

The application automatically tracks the "active work time" for cards.

• Timer Starts: When you drag a card into the Ongoing or Approve lanes, a timer starts.

• Timer Stops: When the card is moved out of those lanes (e.g., to "Done" or "Idea"), the timer stops, and the elapsed time is added to the card's total.

• Display: The total active work time (e.g., "1h 30m") is displayed in the card's footer.

4. Data Management (Local Files)

You have full control over saving and loading your data.

• Save Board:

  • Click the "Save Board" button in the sidebar.

  • This will save your entire board (all lanes and all cards) as a single JSON file with the .VBoard extension (e.g., VeryBoard_2025-10-26.VBoard).

• Load Board:

  • Click the "Load Board" button.

  • Select a .VBoard file from your computer.

  • This will completely replace the current board with the one from the file.

• Save Card:

  • Inside the card editor modal, click "Save Card".

  • This saves only the current card you are editing to a .vbcard file. This is useful for creating templates or backing up a single item.

• Load Card:

  • Click the "Load Card" button in the sidebar.

  • Select a .vbcard file.

  • The card will be loaded and added to the "Idea" lane.

5. Reminder System

The application features a simple, local reminder system.

• Check Reminders:

  • Click the "Check Reminders" button in the sidebar.

  • The app scans all cards on your board.

  • If any card's (Due Date - Reminder Days) equals today's date, it will appear in a pop-up modal.

• Send Single Reminder:

  • Inside the card editor, click "Send Reminder".

  • This will open your computer's default email client (like Outlook, Apple Mail, etc.) with a pre-filled mailto: link.

  • The email will be addressed to the "Owner" and contain the card's title, description, and due date.

6. Settings

• Dark Theme: Use the "Dark Theme" toggle switch in the sidebar to switch between light and dark modes.

7. Technology Stack

VeryBoard is built with modern, client-side technologies:

• HTML5 & CSS3: For structure and styling.

• JavaScript (ES Modules): For all application logic.

• Material 3 Web Components: Provides the Material Design 3 user interface components.

• Flatpickr: A lightweight library used for the "Due Date" calendar.