Skip to main content

​
Overview

Widgets are the building blocks of your Forge dashboard. Each widget provides specific functionality, from displaying GitHub activity to tracking tasks. You can add, remove, resize, and configure widgets to create a personalized workspace.

​
Available Widgets

Bookmark

Store and organize your frequently visited links with custom titles and automatic favicon detection.

Clock

Display the current time in a clean, customizable format.

Countdown

Track time remaining until important dates and events.

Crypto

Monitor cryptocurrency prices with real-time updates and historical charts.

Editor

Create and edit notes with a built-in text editor supporting rich formatting.

Frame

Embed external websites and web applications directly in your dashboard.

GitHub

Track issues, pull requests, and repository activity from your GitHub account.

GitHub Heatmap

Visualize your GitHub contribution activity over time.

Inbox

Monitor your email inbox with Google integration.

Kanban

Organize tasks using a Kanban board with drag-and-drop functionality.

Meetings

View upcoming meetings from your Google Calendar.

Todo

Manage your tasks with a simple, focused todo list.

Weather

Check current weather conditions and forecasts for your location.

​
Adding Widgets

1

Enter Edit Mode

Click the “Edit” button in the top navigation to enable widget editing.
2

Open Widget Gallery

Click the “Add Widget” button to view all available widgets.
3

Select a Widget

Browse the widget gallery and click on the widget you want to add to your dashboard.
4

Position the Widget

The widget appears on your dashboard. Drag it to your desired position on the grid.
5

Exit Edit Mode

Click “Done” to save your changes and exit edit mode.
Some widgets require integration with external services (like GitHub or Google) before they can be used. You’ll be prompted to connect your account when adding these widgets.

​
Configuring Widgets

Each widget has its own configuration options accessible through the widget header:
Click the menu icon in the widget header to access configuration options specific to that widget type. Common settings include:
  • Display preferences: Customize what information is shown
  • Refresh intervals: Set how often data updates
  • Filters: Control which items appear in the widget
  • Appearance: Adjust colors, sizes, and visual styles

​
Removing Widgets

To remove a widget from your dashboard:
1

Enter Edit Mode

Enable edit mode by clicking the “Edit” button in the navigation.
2

Delete Widget

Click the delete icon (trash can) in the widget header.
3

Confirm Deletion

Confirm that you want to remove the widget. This action is permanent.
Deleting a widget removes all its configuration and data. For widgets like Editor or Bookmark, this means losing your saved content permanently.

​
Widget Behavior

​
Edit Mode vs. View Mode

In view mode:
  • Widgets are interactive and display live data
  • You can click links, complete tasks, and interact with widget content
  • Widgets cannot be moved or deleted
  • The layout is locked to prevent accidental changes

​
Auto-Save

All widget changes are automatically saved:
  • Position updates save when you finish dragging
  • Configuration changes save immediately
  • Widget additions and deletions are instant
  • No manual save action required

​
Error Handling

Widgets handle errors gracefully:
  • Integration Required: Widgets needing external accounts show a connection prompt
  • Loading States: Skeleton screens display while data loads
  • Error Messages: Clear error messages with retry options when data fails to load
  • Fallback UI: Widgets degrade gracefully when services are unavailable
Organize related widgets together on your dashboard. For example, group all productivity widgets (Todo, Kanban, Meetings) in one area and information widgets (Weather, Crypto) in another.

​
Widget-Specific Features

​
Bookmark Widget

  • Add unlimited bookmarks with custom titles
  • Automatic favicon detection
  • Drag-and-drop reordering
  • Quick access to frequently visited sites

​
GitHub Widgets

  • Filter by repository, labels, and status
  • Real-time updates for issues and pull requests
  • Contribution heatmap visualization
  • Direct links to GitHub for quick actions

​
Kanban Widget

  • Multiple columns with custom names
  • Drag-and-drop task management
  • Color-coded cards
  • Progress tracking

​
Editor Widget

  • Rich text editing with markdown support
  • Auto-save functionality
  • Syntax highlighting for code blocks
  • Full-screen mode for focused writing

​
Next Steps

Customize Layout

Learn how to arrange widgets and customize your dashboard appearance

Connect Integrations

Set up integrations with GitHub, Google, and other services

Build docs developers (and LLMs) love

Get started for freeTalk to us