The new home of the ThreadR Forum Engine https://threadr.lostcave.ddnss.de

Go to file

Joca 935446280f Chat: Add real-time connection status, typing indicators, smart scrolling, and message delivery status Features added: - Connection status indicator (green=connected, yellow=connecting, red=disconnected) - Exponential backoff reconnection (1s → 2s → 4s → ... → 30s max) - Typing indicators showing who is typing (up to 3 users, with overflow count) - Message status (⋯ sending, ✓ sent, ✗ failed with retry option) - Jump-to-bottom button with unread message count badge - Smart scroll preservation (stays in place unless already at bottom) - Optimistic UI for sent messages (appears immediately, updates with real status) - Backend support for broadcasting typing events to other users		2026-01-15 23:00:31 -03:00
config	All: Enhance session management and security features	2025-12-21 21:26:02 -03:00
handlers	Chat: Add real-time connection status, typing indicators, smart scrolling, and message delivery status	2026-01-15 23:00:31 -03:00
legacy	everything: Delete everything, full project reset. Keep a copy of variable_grabbler in case we ever need it.	2025-06-15 02:25:56 +02:00
models	using bcrypt	2025-12-07 21:30:23 -03:00
static	UI: Add navigation improvements with breadcrumbs, back buttons, scroll-to-top, and keyboard shortcuts	2026-01-15 22:49:54 -03:00
templates	Chat: Add real-time connection status, typing indicators, smart scrolling, and message delivery status	2026-01-15 23:00:31 -03:00
.gitignore	Quick .gitignore update so this shit does not bother me anymore	2026-01-15 22:34:58 -03:00
DOCUMENTATION.md	All: Enhance session management and security features	2025-12-21 21:26:02 -03:00
README.md	README: rip out all the leftovers that are no longer relevant to the new implementation	2025-06-15 02:47:16 +02:00
go.mod	All: Enhance session management and security features	2025-12-21 21:26:02 -03:00
go.sum	All: Enhance session management and security features	2025-12-21 21:26:02 -03:00
main.go	All: Enhance session management and security features	2025-12-21 21:26:02 -03:00

README.md

Welcome to ThreadR Rewritten

This is the source code for the ThreadR Forum Engine, rewritten in Go. ThreadR is a free and open-source forum engine designed to allow users to host their own forum instances on personal web servers.

Project Overview

ThreadR was originally started as a school project in 2019 with the aim of creating a hybrid between a forum and a social media platform. It was built with PHP and (back then still) MySQL. After we finished school, it was temporarily abandoned. An attempt was made to revive it in 2020, open-sourcing the code and making some things configurable, but not much else happened. Here we are now, with a full rewrite in Go started in 2025.

Project Setup

This is for development only. Currently, ThreadR is not ready for production use.

Prerequisites

UNIX-like OS
Go (golang)
Mariadb

Setup Steps

Create a mariadb user and database for ThreadR (the names can be changed):

CREATE USER threadr IDENTIFIED BY 'super secure password';
CREATE DATABASE `threadr`;
GRANT ALL PRIVILEGES ON `threadr`.* TO 'threadr';

Create a config file: In the config subdirectory, cp config.json.sample config.json and edit it to suit your needs.
Create an about page: Also in the config subdirectory, cp about_page.htmlbody.sample about_page.htmlbody and edit it to suit your needs.

Running the Application

After configuration, run the following command once to initialize the DB:

go run main.go --initialize

To start the ThreadR server, run this:

go run main.go

The server will start on port 8080 by default.

Contributing

We welcome contributions! Please join our Discord server to get in touch: discord.gg/r3w3zSkEUE.

License

ThreadR is licensed under the Apache 2.0 License. See LICENSE.md for details.

Authors: BodgeMaster, Jocadbz