Community Dashboard

The IrregularChat community uses a suite of interconnected web services that integrate with the Signal bot. This page provides an overview of all community web services.

Service Overview

Service	URL	Purpose
Main Dashboard	https://irregulars.io	Community hub and navigation
Events	https://event.irregulars.io	Event management, RSVPs, polls
RSS Reader	https://rss.irregulars.io	News aggregation, link sharing
Q&A Web	https://qa.irregulars.io	Questions, answers, voting
Forum	https://forum.irregularchat.com	Discourse community forum
Wiki	https://irregularpedia.org	Community knowledge base
Admin Portal	https://irregulars.io/admin	Admin dashboard (groups, DMs, announcements)
SSO	https://sso.irregularchat.com	Single sign-on (Authentik)

---

Main Dashboard (irregulars.io)

URL: https://irregulars.io

The main community dashboard serves as a central hub for:

• Quick links to all community services
• Community announcements
• Getting started guides
• Navigation to specialized services

---

Events (event.irregulars.io)

URL: https://event.irregulars.io Documentation: Events

Create and coordinate community events with:

• Event creation (quick, AI-parsed, or collaborative planning)
• RSVP tracking (going, maybe, not going)
• Date and venue polls for group decision-making
• Calendar export (ICS files)
• Signal bot integration

Signal Bot Commands

!events                    # List upcoming events
!event quick "Title" time  # Create event
!event parse <description> # AI-powered creation
!event plan dates; venues; desc  # Collaborative planning
!event vote <id>           # Vote on polls
!event rsvp going <id>     # RSVP to event

Key Features

• Polls: Let groups vote on dates and locations
• Privacy: Signal-created events require login
• Sharing: Share events to multiple Signal groups
• Reactions: 👍 to RSVP as going

---

RSS Reader (rss.irregulars.io)

URL: https://rss.irregulars.io Documentation: RSS Reader

Aggregates and curates news, articles, and links shared in Signal groups:

• Browse links by category (news, social, repos, documents)
• Search and filter content
• Bookmark links for later
• Comment and discuss
• Queue links for daily/weekly digests

Signal Bot Commands

!links                     # Recent links from all groups
!links -c                  # Links from current group only
!links -t 24h              # Links from last 24 hours
!links search <term>       # Search shared links

Categories

• News - Articles and news stories
• Social - Social media posts (Twitter/X, etc.)
• Repositories - GitHub, GitLab repos
• Documents - PDFs, files, documents

Authentication

• Browse publicly shared links without login
• Login required for bookmarks, comments, and queuing

---

Q&A Web (qa.irregulars.io)

URL: https://qa.irregulars.io Documentation: Q&A System, Q&A Web API

Web interface for the community Q&A system:

• Browse unanswered questions
• View answered questions with solutions
• Search question history
• Vote on answers

Signal Bot Commands

!ask <question>            # Ask a question
!questions                 # List open questions
!answer <id> <answer>      # Answer a question
!solved <id>               # Mark question as solved
!qa search <term>          # Search Q&A history

Features

• Questions asked via Signal appear on the web
• Answers can be provided via Signal or web
• Voting helps surface best answers
• Solved questions are archived for reference

---

Forum (forum.irregularchat.com)

URL: https://forum.irregularchat.com

Discourse-based community forum for longer discussions:

• Categorized discussions
• Topic subscriptions
• Rich text and media support
• Email notifications

Signal Bot Commands

!fpost <title> | <content> # Create forum post
!flatest                   # Latest forum posts
!fsearch <query>           # Search forum
!categories                # List forum categories

---

Wiki (irregularpedia.org)

URL: https://irregularpedia.org

Community knowledge base (IrregularPedia):

• Community-maintained documentation
• Guides and how-tos
• Reference materials
• Searchable archive

Signal Bot Commands

!wiki                      # Wiki links and info
!wikisearch <query>        # Search wiki content
!wikiask <question>        # AI-powered Q&A from wiki
!wikiindex                 # Browse wiki categories

---

Admin Portal (irregulars.io/admin)

URL: https://irregulars.io/admin

The admin portal provides a web-based dashboard for community administrators, accessible through the main community portal at irregulars.io. Requires SSO login and admin privileges.

Tabs

Tab	Description
Groups	View all Signal groups the bot is in, member counts, group IDs
Members	Browse community members, search by name, view profiles
Announcements	Compose and send announcements to groups or as DMs
Scheduled	View and manage scheduled announcements
DM Inbox	Browse DM conversations and reply to users via the bot
Admin Roles	Manage bot admin privileges (super admin only)

DM Inbox

The DM Inbox tab lets admins read and respond to direct messages sent to the bot:

• Conversation list — All DM conversations that contain actual text messages, sorted by most recent activity. Shows sender name, message preview, message count, and last activity time.
• Thread view — Click a conversation to see the full message thread in chronological order. Messages are displayed as inbound (from user) or outbound (from bot) bubbles.
• Reply — Type a message and send it as a DM from the bot to the user.
• Announcement responses — Sent announcements in the Announcements tab have a “View Responses” button that shows DMs received within 24 hours of the announcement.

Announcements

Compose announcements with the message-first layout:

1. Write the announcement message
2. Choose delivery method: Group message or Direct message
3. Select target groups (for group messages) or let the bot send to all members (for DMs)
4. Preview and send

Group announcements support multi-group delivery. DM announcements send individual messages to each member of the selected groups.

Admin Role Management

Super admins can manage bot admin privileges:

• Add admin — Grant admin access by Signal UUID
• Remove admin — Revoke admin access
• View admins — List all current bot admins with their roles

API Endpoints

Endpoint	Method	Description
/api/admin/groups	GET	List all bot groups
/api/admin/members	GET	List community members
/api/admin/announce	POST	Send announcement
/api/admin/dm/conversations	GET	List DM conversations
/api/admin/dm/conversations/:uuid	GET	Full DM thread for one person
/api/admin/dm/announcement/:id/responses	GET	DMs correlated to an announcement
/api/admin/dm/send	POST	Send DM reply
/api/admin/bot-admins	GET	List bot admins
/api/admin/bot-admins	POST	Add bot admin
/api/admin/bot-admins/:uuid	DELETE	Remove bot admin

---

Single Sign-On (sso.irregularchat.com)

URL: https://sso.irregularchat.com

Authentik-based single sign-on provides:

• One account for all services
• Secure authentication
• Group-based permissions
• Account management

Signal Bot Commands

!createuser <username>     # Create SSO account (admin)
!accountinvite <email>     # Send account invite (admin)

---

Architecture

┌─────────────────────────────────────────────────────────────┐
│                     Signal Groups                            │
│                    (via Signal Bot)                          │
└─────────────────────────┬───────────────────────────────────┘
                          │
                          ▼
┌─────────────────────────────────────────────────────────────┐
│                   Signal Bot Server                          │
│              (Docker on Proxmox/Self-hosted)                │
│                                                              │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐         │
│  │  Commands   │  │   API       │  │  Database   │         │
│  │  Handler    │  │  Server     │  │  (Postgres) │         │
│  └─────────────┘  └─────────────┘  └─────────────┘         │
└─────────────────────────┬───────────────────────────────────┘
                          │
          ┌───────────────┼───────────────┬───────────────┐
          │               │               │               │
          ▼               ▼               ▼               ▼
    ┌───────────┐   ┌───────────┐   ┌───────────┐   ┌───────────┐
    │  Events   │   │    RSS    │   │    Q&A    │   │   Forum   │
    │ (CF D1)   │   │  Reader   │   │   Web     │   │ (Discourse)│
    │           │   │ (CF KV)   │   │ (CF KV)   │   │           │
    └───────────┘   └───────────┘   └───────────┘   └───────────┘
         │               │               │               │
         └───────────────┴───────────────┴───────────────┘
                                │
                                ▼
                    ┌─────────────────────┐
                    │     Authentik       │
                    │   (SSO Provider)    │
                    └─────────────────────┘

Technology Stack

Service	Platform	Database
Signal Bot	Docker (Proxmox)	PostgreSQL
Events	Cloudflare Workers	D1 (SQLite)
RSS Reader	Cloudflare Workers	KV + PostgreSQL
Q&A Web	Cloudflare Workers	KV + PostgreSQL
Forum	Self-hosted	PostgreSQL
Wiki	Gitea Wiki	Git
SSO	Authentik	PostgreSQL

---

Authentication Flow

All services use Authentik for authentication:

1. User clicks “Login” on any service
2. Redirect to sso.irregularchat.com
3. User authenticates (password, passkey, etc.)
4. Redirect back with OIDC token
5. Service creates session

Shared Session Benefits

• Single login for all services
• Consistent user identity
• Centralized account management
• Group-based access control

---

Deployment

Cloudflare Workers (Events, RSS, Q&A)

# Deploy all workers
cd event-service && npx wrangler deploy
cd ../rss-reader && ./deploy.sh
cd ../qa-web-form && ./deploy.sh

Signal Bot

# Full deployment
./deploy.sh deploy --no-cache

# Quick sync
./deploy.sh sync

Configuration

Each service requires environment variables and secrets. See:

• Configuration Reference
• Deployment Guide

---

Related Pages

• Events - Full event system documentation
• RSS Reader - RSS aggregation and link sharing
• Q&A System - Signal Q&A commands
• Q&A Web API - Q&A web interface API
• RSS Reader API - RSS reader API reference