DEV Community: hongsheng yang

FlatBB : un forum open source qui s’installe en décompressant un zip

hongsheng yang — Thu, 10 Sep 2026 09:25:03 +0000

Vous voulez un vrai forum — sujets, réponses, Markdown, recherche, mode sombre — sans Composer, sans Docker, sans pipeline Node qui casse à chaque mise à jour. FlatBB est un forum libre en PHP 8 pur : on décompresse, on ouvre l’URL, on choisit SQLite ou MySQL, on crée le compte admin. C’est toute la procédure.

Site : https://www.flatbb.com/ · Téléchargement : https://www.flatbb.com/download · Code : [https://github.com/nwnuyhs/flatbb](https://github.com/nwnuyhs/fl C’est fait pour les indépendants, les associations et les petites équipes qui veulent un espace de discussion aujourd’hui, pas après une semaine d’ops.

Fonctionnalités complètes dès la première minute

FlatBB n’est pas une coquille vide. Dès l’installation vous avez :

Catégories et tags pour organiser les discussions
Markdown pour les sujets et les réponses (aperçu, mentions @, pièces jointes)

Une interface nette, aussi sur mobile

Le design est volontairement calme : cartes, typographie lisible, colonnes qui se replient proprement sur téléphone. La navigation, la recherche, le bouton « nouveau sujet » et le menu compte restent accessibles sur petit écran. Pas de thème « desktop only » à rattraper ensuite : le responsive est dans le cœur du produit.

Pour une communauté qui lit surtout depuis le téléphone — parents d’élèves, club local, support produit — ce détail change tout. On écrit, on répond, on cherche, sans zoomer ni se battre avec un menu caché.

Des plugins pensés pour l’IA (et pour les humains)

Là où FlatBB se distingue vraiment, c’est l’écosystème d’extensions. Un plugin, c’est un dossier + un fichier plugin.php. Toute la spécification — hooks, routes, réglages, sécurité, base de données — tient dans un seul document texte :

https://www.flatbb.com/dev/plugins.md

Vous collez cette URL (ou le fichier) dans Claude, ChatGPT, Cursor ou Codex, vous décrivez la fonctionnalité, et l’assistant produit un plugin

SEO Pro et Guard : gratuits sur le marché

Deux plugins officiels méritent une mention rapide :

SEO Pro (gratuit) — titres et métas, sitemaps, données structurées, redirections, IndexNow, analytics : https://www.flatbb.com/market/seo_pro
Guard (gratuit) — 2FA, journal d’admin, bans IP, contrôle sécurité, alertes de connexion : https://www.flatbb.com/market/guard

À installer depuis Admin → Market. Le noyau est déjà soigné (CSRF, échappement, CSP) ; ces plugins couvrent le quotidien SEO et sécurité sans facture.

Pour qui ?

FlatBB convient si vous voulez :

un forum sur hébergement mutualisé ou VPS léger
une stack que vous comprenez (PHP + SQLite/MySQL)
des extensions que vous (ou une IA) pouvez écrire en une soirée
une UI propre, mobile, avec Markdown et recherche dès le premier jour

Licence MIT, code ouvert sur GitHub. Essayez : télécharger FlatBB, lisez le guide plugins, et posez votre première communauté avant la fin de la pause café.prêt à zipper et à uploader dans Admin → Plugins. Pas de build, pas de CLI obligatoire pour livrer. Le marketplace permet aussi l’installation en un clic et la publication de vos propres extensions.

C’est rare : un forum dont l’API d’extension est assez petite et stable pour qu’un modèle de langage la suive correctement. Vous gagnez des heures, et vous restez maître du code.

Recherche plein texte intégrée
Mode sombre et bascule de thème côté visiteur
Interface multilingue : chaque membre choisit sa langue
Notifications, likes, signets, profils, panneau d’administration

Autrement dit : les bases d’une communauté sérieuse sont là, sans plugin obligatoire pour « juste poster ».atbb)

Installation : unzip, pas de stack

La plupart des forums « modernes » partent du principe que vous avez Docker, Composer et une CI. Sur un hébergement mutualisé à deux euros, ça ne marche pas. FlatBB a choisi l’autre chemin :

PHP 8, sans framework et sans étape de build
Décompressez le zip dans le dossier web
Ouvrez l’URL, lancez l’assistant, choisissez SQLite (zéro config) ou MySQL
Créez l’administrateur — le forum tourne

Pas de composer install, pas d’image Docker à maintenir, pas de build frontend. Vous pouvez même déployer via FTP.

FlatBB: انجمن متن‌باز با پشتیبانی کامل از راست‌به‌چپ و فارسی — نصب فقط با Unzip

hongsheng yang — Thu, 10 Sep 2026 09:17:34 +0000

اگر دنبال یک انجمن واقعی هستید — موضوع، پاسخ، مارک‌داون، جستجو، حالت تاریک — ولی نمی‌خواهید Composer، Docker یا پایپ‌لاین Node را نگه دارید، FlatBB همان انتخاب است. یک انجمن آزاد با PHP 8 خالص: فایل را از حالت فشرده خارج کنید، آدرس را باز کنید، SQLite یا MySQL را انتخاب کنید، حساب مدیر بسازید. تمام. و مهم‌تر از همه برای جامعهٔ فارسی‌زبان: راست‌به‌چپ (RTL) و فارسی از همان هسته پشتیبانی می‌شوند؛ نه به‌عنوان وصلهٔ بعدی.

سایت: https://www.flatbb.com/ · دانلود: [https://www.flatbb.com/download](https://www.flatbb.com/downlo

رابط تمیز، موبایل‌محور — و راست‌به‌چپ واقعی برای فارسی

طراحی عمداً آرام است: کارت‌ها، تایپوگرافی خوانا، ستون‌هایی که روی گوشی درست جمع می‌شوند. ناوبری، جستجو، «موضوع جدید» و منوی حساب روی صفحهٔ کوچک در دسترس می‌مانند. تم «فقط دسکتاپ» نیست که بعداً نجاتش دهید: واکنش‌گرایی در هسته است.

برای فارسی‌زبانان نکتهٔ کلیدی این است: هسته وقتی بستهٔ زبانی RTL باشد، جهت سند را درست تنظیم می‌کند. استایل‌ها با ویژگی‌های جهت‌خنثی نوشته شده‌اند (margin-inline و مشابه آن) تا چینش در فارسی برعکس نشود و متن کاربر با dir="auto" درست نمایش داده شود. یعنی انجمن فارسی‌تان نه «انگلیسی با فونت فارسی»، بلکه رابط راست‌به‌چپ بومی است — منوها، فرم‌ها، لیست موضوعات و محتوای پست‌ها در جهت درست می‌نشینند.

برای جوامعی که بیشتر با موبایل می‌خوانند — والدین، باشگاه‌های محلی، پشتیبانی محصول — این ترکیب (موبایل + RTL) تفاوت واقعی می‌سازد. می‌نویسید، جواب می‌دهید، جستجو می‌کنید؛ بدون زوم و بدون منوی پنهان.

پلاگین‌های دوست‌دار هوش مصنوعی

جایی که FlatBB واقعاً متمایز می‌شود، مدل افزونه است. یک پلاگین یعنی یک پوشه + یک plugin.php. کل مشخصات — هوک، مسیر، تنظیمات، امنیت، پایگاه‌داده — در یک سند متنی جمع شده:

https://www.flatbb.com/dev/plugins.md

این آدرس (یا فایل) را به Claude، ChatGPT، Cursor یا Codex بدهید، قابلیت را توصیف کنید؛ دستیار یک پلاگین آمادهٔ زیپ و آپلود در Admin → Plugins تحویل می‌دهد. بدون بیلد، بدو

SEO Pro و Guard: رایگان در بازار

دو پلاگین رسمی کوتاه یادآوری می‌شوند:

SEO Pro (رایگان) — عنوان و متا، سایت‌مپ، دادهٔ ساخت‌یافته، ریدایرکت، IndexNow، آنالیتیکس: https://www.flatbb.com/market/seo_pro
Guard (رایگان) — احراز هویت دو مرحله‌ای، لاگ مدیر، بن IP، چک امنیتی، هشدار ورود: https://www.flatbb.com/market/guard

نصب از Admin → Market. هسته از قبل سخت‌شده است (CSRF، escape، CSP)؛ این دو افزونه کارهای روزمرهٔ سئو و امنیت را بدون فاکتور پوشش می‌دهند. برای بسیاری انجمن‌ها، هسته به‌علاوهٔ همین دو، بستهٔ شروع کافی است.

برای چه کسانی؟

FlatBB مناسب است اگر می‌خواهید:

انجمنی روی هاست اشتراکی یا VPS سبک
پشته‌ای که می‌فهمید (PHP + SQLite/MySQL)
افزونه‌هایی که خودتان (یا یک AI) در یک عصر می‌نویسید
رابط تمیز و موبایل با مارک‌داون و جستجو از روز اول
و برای فارسی: RTL داخلی، نه افزونهٔ جانبی

مجوز MIT، کد باز روی GitHub. امتحان کنید: FlatBB را دانلود کنید، راهنمای پلاگین را بخوانید، و قبل از سرد شدن چای جامعهٔتان را بالا بیاورید.ن CLI اجباری برای انتشار. از Marketplace هم با یک کلیک نصب می‌کنید و می‌توانید افزونهٔ خودتان را منتشر کنید.

کم پیش می‌آید API افزونهٔ انجمنی آن‌قدر کوچک و پایدار باشد که مدل زبانی درست دنبالش کند. ساعت‌ها صرفه‌جویی می‌کنید و مالک کد می‌مانید. همان قواعد برای انسان‌ها هم خوانا است: فضای نام روشن، تنظیمات اعلانی، هوک به‌جای وصله زدن به هسته. اگر افزونه‌ای برای فارسی یا RTL می‌خواهید، همان سند را به دستیار بدهید و بخواهید CSS جهت‌خنثی رعایت شود.ad) · کد: https://github.com/nwnuyhs/flatbb

نصب آسان: Unzip، بدون Composer و Docker

بیشتر انجمن‌های «مدرن» فرض می‌کنند Docker، Composer و CI دارید. روی هاست اشتراکی ارزان همین‌جا کار می‌ترکد. FlatBB راه دیگری رفته است:

PHP 8، بدون فریم‌ورک و بدون مرحلهٔ بیلد
زیپ را در پوشهٔ وب باز کنید
URL را باز کنید، نصب‌کننده را طی کنید، SQLite (بدون پیکربندی) یا MySQL را بزنید
مدیر بسازید — انجمن بالا می‌آید

نه composer install، نه ایمیج داکر برای نگهداری، نه بیلد فرانت. حتی FTP کافی است. مناسب فریلنسرها، انجمن‌های محلی، گروه‌های آموزشی و تیم‌های کوچک که امروز می‌خواهند جامعه داشته باشند، نه بعد از یک هفته Ops. اگر رشد کردید همان کد می‌ماند؛ فقط ترافیک بیشتر و در صورت نیاز MySQL.

امکانات کامل از همان دقیقهٔ اول

FlatBB پوستهٔ خالی نیست. بلافاصله بعد از نصب دارید:

دسته‌بندی و برچسب برای نظم گفتگوها
مارک‌داون در موضوع و پاسخ (پیش‌نمایش، منشن @، پیوست)
جستجوی متن کامل در هسته
حالت تاریک و تعویض تم برای هر بازدیدکننده
چندزبانه بودن رابط: هر عضو زبان خودش را انتخاب می‌کند
اعلان، لایک، نشانک، پروفایل، پنل مدیریت

یعنی پایه‌های یک جامعهٔ جدی از روز اول آماده‌اند؛ بدون پلاگین اجباری فقط برای پست گذاشتن. مدیریت، ساختاربندی و جستجو فوری کار می‌کند؛ افزونه‌ها وقتی لازم شدند اضافه می‌شوند.

FlatBB Guard: operational security on top of a hardened core

hongsheng yang — Thu, 10 Sep 2026 08:52:22 +0000

FlatBB’s core already escapes output, verifies CSRF on every POST, ships a Content Security Policy, and re-asks the admin password on high-risk pages. Guard is the free operational-security plugin that watches what happens on top of that stack.

Plugin page: https://www.flatbb.com/market/guard

What Guard adds

Two-factor sign-in (Guard 1.1+)

Authenticator apps (TOTP), eight recovery codes, secrets encrypted with the site secret. Optional rule: staff must use 2FA. Available for staff only or for every member.

Admin Security toolkit

Check-up — HTTPS, CSP mode, real IP behind proxies, data/ not web-accessible, no PHP in uploads/, debug flags, site secret, PHP version, scheduled jobs, staff accounts, registration, new-address staff sign-ins, CSP reports
Admin log — searchable core action log (action, target, detail, IP)
Sign-ins — per account/address history; new addresses in the last 7 days marked; Sign out everywhere without changing the password
Bans — IP or CIDR, permanent or timed; admins never blocked
Warnings notify staff about script-like text in posts/profiles (content is already escaped by the core)
Probes record scanner paths (wp-admin, .env, .git, backups, plugin PHP…), one-click ban, ignore the server probing itself

Alerts

Sign-in from a never-seen address in-app notification (and optional email), for staff by default or for everyone.

Why this matters

A lightweight PHP forum on shared hosting still gets scanned. Guard turns “secure defaults” into day-to-day ops: see whos knocking, ban ranges, force 2FA for mods, and keep an audit trail — without buying a separate WAF product.

Get it

FlatBB: https://www.flatbb.com/
Guard: https://www.flatbb.com/market/guard
Install: Admin → Market → search guard

Requires FlatBB 0.1.26+ (newer features need later cores; Probes needs 0.1.58+).

Disclosure: I’m the author of FlatBB.

FlatBB is built for Google: free SEO Pro vs commercial SEO plugins

hongsheng yang — Thu, 10 Sep 2026 08:35:44 +0000

Most forum stacks treat SEO as an afterthought or sell it as a paid add-on. FlatBB takes the opposite approach: the core is crawl-friendly, and SEO Pro is a free, certified plugin that covers the same ground as big commercial SEO products (title/meta templates, sitemaps, schema, redirects, IndexNow, analytics).

Plugin page: https://www.flatbb.com/market/seo_pro

Why FlatBB indexes well

Clean public URLs for topics, categories, and tags
Only signed-out-readable content goes into sitemaps (hidden / gated topics stay out)
Editable robots.txt with a Sitemap line
Canonicals and “Page N” handling for paginated lists
Indexing rules for thin pages (member profiles are noindex by default)

What free SEO Pro includes (commercial-plugin territory)

Titles & meta — templates per page type (home, topic, category, tag, member) with variables like %title%, %site%, %excerpt%, %replies%. Per-topic overrides for moderators.

Share cards — Open Graph + X cards; image fallback: override → first post image → avatar site default. Gated topics emit no share tags (no private leaks).

Structured data (JSON-LD) — WebSite + SearchAction + Organization on home; BreadcrumbList everywhere; DiscussionForumPosting on topics; CollectionPage / ProfilePage; QAPage when Q&A marks an accepted answer.

Sitemaps — /sitemap.xml index with paged topic files (lastmod + images), categories, tags, optional users, plus URLs from other plugins.

Redirects & 404 log 301/302 for moved URLs; 404 log with referrer and one-click “Redirect…”.

IndexNow — notify Bing/Yandex/Naver/Seznam when topics are posted or edited (Google still uses the sitemap).

Analytics — GA4, Plausible, Umami, Matomo, CSP-safe.

Compared with commercial SEO plugins

You usually pay for Yoast / Rank Math / AIOSEO-class features on WordPress. Forum vendors often charge for “SEO packs.” On FlatBB, SEO Pro is free in the official marketplace (Admin → Market → seo_pro), replaces the older SEO Meta plugin, and is aimed at real forum pages — discussions, categories, tags not blog posts bolted onto a CMS.

Get it

FlatBB: https://www.flatbb.com/
SEO Pro: https://www.flatbb.com/market/seo_pro
Download: https://www.flatbb.com/download

Disclosure: I’m the author of FlatBB.

FlatBB — easy install, full features, clean UI, and AI-built plugins

hongsheng yang — Thu, 10 Sep 2026 07:17:24 +0000

FlatBB — easy install, full features, clean UI, and AI-built plugins

FlatBB is an open-source forum in plain PHP 8.1+ for communities that want a modern board without Docker/Composer/build pipelines.

Easy install & deploy

Unzip → open the URL → pick SQLite or MySQL → create admin. No framework, no Composer, no Docker, no build step. Runs on cheap shared hosting. One-click upgrades: Admin → Updates.

Download: https://www.flatbb.com/download

Feature-complete

Categories & permissions, tags, Markdown, @mentions, attachments, notifications, full-text search, dark mode, mobile layout, multilingual + built-in RTL, core points (0.1.70), plugin marketplace.

Clean UI

Three-column desktop, solid mobile layout, dark mode, language globe, RTL mirroring, uploadable category icons, and a draggable header-right layout in Admin → Layout.

AI-friendly plugins

One plugin = one folder + plugin.php. The whole API fits in one doc you can hand to Claude, Codex, or Cursor:

https://www.flatbb.com/dev/plugins.md

Describe the feature → get a zip → install (or publish to the marketplace). Marketplace: https://www.flatbb.com/market

FlatBB 0.1.70: points move into the core

hongsheng yang — Thu, 10 Sep 2026 04:48:41 +0000

FlatBB 0.1.70 (2026-09-09) turns community points into a first-class core feature — not a bolt-on plugin.

What’s new in 0.1.70

Points rules in Admin → Points

Admins get one table for what each action pays: new topic, reply, like received, like given. You set how many times a day an action can pay a member, and whether the rule is on. Plugins can add their own rows. A post pays once, no matter how often it is edited or re-liked.

Every member gets /points

The user menu shows the balance and a /points page with:

this month’s earnings and spending
history split into All / Earned / Spent, each line linking back to the post
“How to earn points” generated from the live rule table

Points & Leaderboard split

The old Points & Leaderboard plugin is retired. Rules live in the core; the top-members card, /leaderboard, and profile rank move to a new Leaderboard plugin. Update Points to 3.0.0 (stub), disable it, then install Leaderboard.

For plugin authors

New APIs: points_award(), points_revoke(), hook points.rules, region points.actions (see PLUGIN.md §14a).

Related: 0.1.69 licence note

From 0.1.69, FlatBB is free software under GNU AGPL-3.0-or-later. Plugins and themes may use any licence. Releases through 0.1.68 remain MIT. Organisations that cannot accept AGPL can look into a commercial licence.

Get it

Download: https://www.flatbb.com/download
Site: https://www.flatbb.com/
GitHub: https://github.com/nwnuyhs/flatbb

Upgrade path for existing installs: Admin → Updates (one click).

Disclosure: I’m the author of FlatBB.

FlatBB vs Discourse, Flarum, and phpBB: a lightweight PHP forum for shared hosting — and for AI

hongsheng yang — Wed, 09 Sep 2026 06:27:45 +0000

Most “modern” forum stacks assume you have Docker, Composer, Redis, and spare RAM. A lot of real communities only have cheap shared hosting and an FTP client. FlatBB is a free MIT-licensed forum in plain PHP 8.1+ aimed at that reality: unzip a folder, open the installer, pick SQLite or MySQL, and you’re live.

This post compares FlatBB with Discourse, Flarum, and phpBB/MyBB, then explains why its plugin system is deliberately AI-friendly.

Quick comparison

	Discourse	Flarum	phpBB / MyBB	FlatBB
Stack	Ruby, Postgres, Redis, Docker	PHP + Composer	Classic PHP	Plain PHP 8.1+
Install	Container / launcher	Composer / SSH often	Upload + installer	Unzip + browser installer
Hosting fit	VPS 2–4GB+	Shared/VPS with Composer	Shared hosting	Cheapest shared hosting
UX	Excellent modern	Clean modern	Dated by default	Discourse-style three-column, dark mode, mobile
RTL / i18n	Strong	Often needs RTL extension	Language packs	Built-in packs + RTL mirroring (incl. Persian)
Extensibility	Plugins	Extensions	Mods	Plugins + marketplace
License	GPL	MIT	GPL / LGPL	MIT

vs Discourse

Discourse is the gold standard for large, active communities: moderation, trust levels, email digests, ecosystem. The trade-off is operational weight Docker, Postgres, Redis, and enough RAM that a $2–5 shared plan is out of the question.

Choose Discourse if you have a real VPS budget and need enterprise-grade community tooling.

Choose FlatBB if you want a modern-feeling board without containers same “community forum” goal, different hosting constraints.

vs Flarum

Flarum is elegant and lighter than Discourse, but many installs still expect Composer and a host that can run the PHP toolchain. Extensions are powerful; RTL historically needed extra work.

FlatBB keeps the “upload and go” path: no Composer, no build step. Language packs ship in the box (EN/DE/FR/ES/PT/IT/NL/FA). When a pack is RTL, layout, drawer, and icons mirror with dir="rtl". Posts follow their own writing direction for mixed communities.

vs phpBB / MyBB

Classic boards still win on familiarity and “just upload it.” FlatBB keeps that deploy model but ships a cleaner three-column UI, Markdown with live preview, FTS search, notifications, one-click upgrades, and a smaller plugin surface aimed at AI assistants.

AI-friendly by design

The part we’re most intentional about is plugins:

A plugin is one folder with a plugin.php manifest (routes, hooks, settings, admin pages, jobs).
The whole API fits in a single document: https://www.flatbb.com/dev/plugins.md
Paste that into Claude Code, Codex, or Cursor, describe the feature, and upload the zip in Admin → Plugins (or publish to the marketplace).
Naming, security (h(), CSRF), and SQL portability rules live in that same file so assistants dont invent host-specific SQL.

Every bundled plugin was built this way. Marketplace: https://www.flatbb.com/market

Who FlatBB is for

Small/medium communities on shared hosting or a tiny VPS
Admins who refuse Docker for a hobby forum
Multilingual / RTL communities (Persian, Arabic, Hebrew-ready layout mirroring)
Builders who want AI to scaffold plugins instead of reading 50 hook docs first

FlatBB: multilingual out of the box, with a full forum feature set

hongsheng yang — Tue, 08 Sep 2026 12:20:41 +0000

Most “lightweight” forums cut corners. FlatBB is different: plain PHP 8.1+, no Composer/Docker/build step — but the feature list is what small communities actually need.

Built-in languages

Interface packs ship in the box:

English, German, French, Spanish, Portuguese, Italian, Dutch
Persian (فارسی) with full RTL layout mirroring

Also:

Header globe language switcher (remembered for visitors; members can set Preferences)
Admin default language
Per-visitor time zones for displayed times; site timezone for email/feeds/logs
Post text follows its own writing direction (mixed-language communities work)

Core features

Discussion: nested categories (one level) + per-group permissions, tags, topics/replies, quotes, @mentions, Markdown + live preview, drag/paste image upload, likes, bookmarks, unread tracking, notifications.

Discovery: full-text search (SQLite FTS5 / MySQL FULLTEXT), Latest / Top / Unread, clean URLs, RSS, sitemap, profiles & avatars.

UX: Discourse/Flarum-style three-column layout that collapses on phones, dark mode, one-click upgrades.

Admin: settings, categories, tags, users, groups, layout blocks, plugins, scheduled jobs, tools.

Need more? The marketplace and AI-friendly plugin API cover SEO, social login (Google/GitHub/X), Q&A, levels, verified badges, Guard/2FA, drafts, and more. Plugin docs for assistants: https://www.flatbb.com/dev/plugins.md

Install a forum on $2 shared hosting in 2 minutes: no Composer, no Docker, no build step

hongsheng yang — Fri, 04 Sep 2026 14:37:21 +0000

Most forum software today assumes you have a build pipeline. Discourse wants Ruby, Docker, Redis and Postgres. Flarum is PHP but still needs Composer and a terminal. That is fine for a company running a big community, but it rules out the hosting most small communities actually have: a $2 shared plan with a file manager and a MySQL database.

FlatBB is a flat, lightweight forum I wrote for exactly that case. Plain PHP 8, no framework, no Composer, no build step, MIT licensed. This post is the whole installation, then the part I find more interesting: writing plugins for it with an AI assistant.

What you need

Any host with PHP 8.1 or newer (pdo_sqlite or pdo_mysql, mbstring)
A MySQL 5.7+ database, or nothing at all if you use SQLite
A way to put files on the server: FTP, the hosting file manager, or unzip over SSH if you have it

Step 1: download and unzip

Get the zip from https://www.flatbb.com/download and unzip it. You get one folder, flatbb-0.1.10/. Rename it to whatever you like or put its contents straight into your web root.

public_html/
  index.php
  core/
  app/
  assets/
  plugins/
  data/        <- config and SQLite file live here, must be writable
  uploads/     <- attachments and avatars, must be writable

If your host lets you set the document root, point it at the folder. If not, the root works too; data/ and uploads/ are protected by the bundled .htaccess (Apache) and the nginx rules in the docs.

Step 2: open the URL

Visit your domain. The installer appears:

Choose the language.
Choose MySQL (enter host, database, user, password) or SQLite (nothing to enter).
Create the admin account.

That is the deployment. There is no step 3. The whole thing took under two minutes on a cheap shared plan when I timed it.

What you get

Categories, tags, flat topics with replies, markdown with mentions and attachments, notifications, full-text search (FTS5 on SQLite, FULLTEXT on MySQL), dark mode, a three-column layout that collapses to one on a phone, and an admin panel for users, groups, categories, layout blocks and plugins. Seven language packs ship in the box.

Upgrades are one click: Admin, Tools, Check for updates. The core is a handful of small PHP files you can read in an afternoon, which matters when something breaks on a host you cannot SSH into.

Plugins: one folder, one manifest

Everything beyond the core is a plugin. A plugin is a folder with a plugin.php that returns a manifest: routes, hooks, settings, admin pages, scheduled jobs, and its own tables through helpers that work on both SQLite and MySQL.

<?php
return [
    'id' => 'hello',
    'name' => 'Hello',
    'version' => '1.0.0',
    'description' => 'Shows a greeting above the topic list.',
    'hooks' => [
        'region.home.top' => 'hello_banner',
    ],
];

function hello_banner(string $html, array $ctx): string
{
    return $html . '<div class="hello-banner">' . h(t('Welcome!')) . '</div>';
}

You install a plugin by uploading the zipped folder in Admin, Plugins, or in one click from the marketplace at https://www.flatbb.com/market.

Writing plugins with an AI assistant

Because the plugin API is small, it fits in a single text file: https://www.flatbb.com/dev/plugins.md. That file is the spec, the hook list and the helper reference in one.

The workflow I use:

Paste the URL above into Claude Code, Codex or Cursor.
Describe the plugin: what it does, where it shows up, its settings, who may use it.
Ask for the finished folder as a zip.
Upload it under Admin, Plugins.

The assistant gets the naming rules (hello_* functions, plugin_hello_* tables, .hello-* CSS), the security rules (escape with h(), never read superglobals, POST plus CSRF for every state change) and the portability rules (no engine-specific SQL) from the same document, so the result usually passes php FlatBB plugin:check first time. Every bundled plugin was built this way.

DEV Community: hongsheng yang

FlatBB : un forum open source qui s’installe en décompressant un zip

Fonctionnalités complètes dès la première minute

Une interface nette, aussi sur mobile

Des plugins pensés pour l’IA (et pour les humains)

SEO Pro et Guard : gratuits sur le marché

Pour qui ?

Installation : unzip, pas de stack

FlatBB: انجمن متن‌باز با پشتیبانی کامل از راست‌به‌چپ و فارسی — نصب فقط با Unzip

رابط تمیز، موبایل‌محور — و راست‌به‌چپ واقعی برای فارسی

پلاگین‌های دوست‌دار هوش مصنوعی

SEO Pro و Guard: رایگان در بازار

برای چه کسانی؟

نصب آسان: Unzip، بدون Composer و Docker

امکانات کامل از همان دقیقهٔ اول

FlatBB Guard: operational security on top of a hardened core

What Guard adds

Two-factor sign-in (Guard 1.1+)

Admin Security toolkit

Alerts

Why this matters

Get it

FlatBB is built for Google: free SEO Pro vs commercial SEO plugins

Why FlatBB indexes well

What free SEO Pro includes (commercial-plugin territory)

Compared with commercial SEO plugins

Get it

FlatBB — easy install, full features, clean UI, and AI-built plugins

FlatBB — easy install, full features, clean UI, and AI-built plugins

Easy install & deploy

Feature-complete

Clean UI

AI-friendly plugins

Links

FlatBB 0.1.70: points move into the core

What’s new in 0.1.70

Points rules in Admin → Points

Every member gets /points

Points & Leaderboard split

For plugin authors

Related: 0.1.69 licence note

Get it

FlatBB vs Discourse, Flarum, and phpBB: a lightweight PHP forum for shared hosting — and for AI

Quick comparison

vs Discourse

vs Flarum

vs phpBB / MyBB

AI-friendly by design

Who FlatBB is for

Links

FlatBB: multilingual out of the box, with a full forum feature set

Built-in languages

Core features

Links

Install a forum on $2 shared hosting in 2 minutes: no Composer, no Docker, no build step

What you need

Step 1: download and unzip

Step 2: open the URL

What you get

Plugins: one folder, one manifest

Writing plugins with an AI assistant

Links