Mastodon Widget

Shows your home timeline and mentions, with the ability to compose posts and reply, favourite, and boost directly from the dashboard.

Requirements

• A Mastodon account on any instance
• A Mastodon access token with read and write scopes

Getting an access token

1. Go to your Mastodon instance (e.g. https://mastodon.social)
2. Open Settings → Development → New Application
3. Name it "Homepage" and enable scopes: read, write
4. Save and copy the Access Token

Configuration

Key	Type	Description
instanceUrl	string	Your instance URL, e.g. https://mastodon.social
accessToken	string	Access token from your app settings
lastSeenMentionId	string	Auto-managed — tracks last-read mention

Features

• Home timeline tab: recent posts from accounts you follow
• Mentions tab: replies and mentions directed at you
• Compose button or m keybinding: open compose modal
• Reply / Favourite / Boost actions on each post
• Media uploads supported in the compose modal (up to 10MB)

Keybinding

Press m anywhere on the page to open the compose modal (when the Mastodon widget is configured and enabled).