Forumly documentation
Everything you need to use, customize and extend the Forumly forum HTML template.
Introduction
Forumly is a modern community-forum HTML template with 5 homepage layouts and 33 inner pages designed around the bbPress forum structure (forum index, single forum, topics, replies, profiles, search and more).
- Tailwind CSS 3, vanilla JavaScript — no jQuery, no frameworks.
- Light and dark themes, responsive from 360px up to a 1440px site width.
- Local fonts, icons and images — no external requests.
- Semantic HTML and accessible interaction patterns.
Quick start
No build step is required to view or use the template: open index.html in a browser (or upload the folder to any web server). The compiled stylesheet assets/css/style.css is already included.
Editing the CSS (optional)
If you change the Tailwind source or add new classes to the HTML you need to rebuild the stylesheet. Node.js 18 or newer is required.
npm install
npm run dev # watch mode while you edit
npm run build # one-off minified build -> assets/css/style.cssTailwind scans *.html, documentation/*.html and assets/js/*.js (see tailwind.config.js), so every class you use there will be generated.
File structure
forumly/
├── index.html … home-5.html 5 homepage layouts
├── forums.html, forum-single.html, topic-single.html … inner pages (see Pages)
├── pages.html directory of every page
├── assets/
│ ├── css/style.css compiled + minified Tailwind CSS (used by every page)
│ ├── css/phosphor.css icon font stylesheet (optimized subset)
│ ├── js/main.js all interactions (vanilla JS)
│ ├── fonts/ Inter (variable) + Phosphor icon font
│ ├── img/ logos, favicons, avatars/, covers/
│ └── vendor/phosphor-full/ complete Phosphor icon font (optional, for custom icons)
├── src/css/input.css Tailwind source: design tokens + components
├── tailwind.config.js Tailwind configuration
├── package.json build scripts
├── documentation/index.html this file
├── licenses/ third-party license texts + CREDITS.md
├── scripts/subset-icons.py optional: rebuild the optimized icon subset
└── CHANGELOG.mdPages
Every page shares the same header, footer and components. Open pages.html for a clickable directory. The last column shows the planned WordPress / bbPress template for the future theme conversion; it is informational only and not part of this HTML item.
Homepages
| File | Page | Planned WordPress / bbPress template |
|---|---|---|
| index.html | Home 1 — Classic: hero, forum cards, sidebar | — |
| home-2.html | Home 2 — Left sidebar, search hero, card grid | — |
| home-3.html | Home 3 — Centered, tabbed forums, no sidebar | — |
| home-4.html | Home 4 — Board table with fixed left menu | — |
| home-5.html | Home 5 — Magazine bento hero | — |
bbPress forum
| File | Page | Planned WordPress / bbPress template |
|---|---|---|
| forums.html | Forum index — All forums by category | archive-forum.php · loop-forums.php |
| forum-single.html | Single forum — Subforums, topics and new topic form | single-forum.php · loop-topics.php · form-topic.php |
| topics.html | Topic archive — Latest / popular / no replies | bbPress views / topic archive · loop-topics.php |
| topic-single.html | Single topic — Replies, solution, reply form | single-topic.php · loop-replies.php · loop-single-reply.php · form-reply.php |
| new-topic.html | New topic — Create topic form with editor | form-topic.php ([bbp-topic-form]) |
| topic-tag.html | Topic tag — Topics for one tag | taxonomy-topic-tag.php |
| tags.html | Tags index — All tags | [bbp-topic-tags] |
| search.html | Search results — Filters and highlights | content-search.php · form-search.php |
| search-empty.html | No search results — Empty search state | content-search.php (no results) |
| topic-edit.html | Edit topic — Edit + merge / split tools | single-topic-edit.php · form-topic-merge.php · form-topic-split.php |
| reply-edit.html | Edit reply — Edit a reply with revision log | single-reply-edit.php |
| topic-closed.html | Closed topic — Locked topic state | single-topic.php (closed state) |
| forum-empty.html | Empty forum — No topics yet | feedback-no-topics.php |
| no-access.html | Private forum — No-access notice | feedback-no-access.php |
Members
| File | Page | Planned WordPress / bbPress template |
|---|---|---|
| members.html | Members — Directory with filters | plugin / BuddyPress member directory |
| profile.html | Profile — Tabs: overview, topics, replies… | user-profile.php · user-topics-created.php · user-replies-created.php · user-favorites.php · user-subscriptions.php |
| profile-edit.html | Edit profile — Settings with tabs | form-user-edit.php |
| leaderboard.html | Leaderboard — Podium and ranking | plugin (e.g. gamification) |
| notifications.html | Notifications — Filterable list | plugin (notifications) |
| messages.html | Messages — Private messages | plugin (private messages) |
Authentication
| File | Page | Planned WordPress / bbPress template |
|---|---|---|
| login.html | Log in — Split layout | form-user-login.php ([bbp-login]) |
| register.html | Register — Create account | form-user-register.php ([bbp-register]) |
| lost-password.html | Lost password — Reset link | form-user-lost-pass.php ([bbp-lost-pass]) |
Content & utility
| File | Page | Planned WordPress / bbPress template |
|---|---|---|
| blog.html | Blog — Posts archive | home.php / archive.php |
| blog-single.html | Blog post — Article + comments | single.php · comments.php |
| about.html | About us — Story, values, team | page.php |
| contact.html | Contact — Form and info cards | page.php |
| faq.html | Help center / FAQ — Search + accordions | page.php |
| rules.html | Community rules — Document template | page.php |
| page.html | Generic page — Privacy / terms template | page.php |
| 404.html | 404 — Not found page | 404.php |
| maintenance.html | Maintenance — Maintenance mode | — |
| coming-soon.html | Coming soon — Countdown + email capture | — |
Homepage layouts
| File | Layout |
|---|---|
| index.html | Classic: three-row header, category cards, right sidebar |
| home-2.html | Left sidebar, search hero, two-column card grid |
| home-3.html | Centered header, tabbed forum categories, no sidebar, widget row |
| home-4.html | Fixed left menu, classic board table, right widgets |
| home-5.html | Header inside hero, bento hero, three-column categories, wide feed |
All layouts use the same components, so sections can be moved between them by copying the markup.
Colors & themes
All colors are CSS variables defined in src/css/input.css. Light values live in :root, dark values in [data-theme="dark"]. Values are RGB triplets so Tailwind opacity utilities (bg-brand-600/20) keep working.
| Variable | Purpose |
|---|---|
| --brand-50 … --brand-700 | Brand color scale (RGB triplets, e.g. 0 103 178) |
| --head, --head-2, --head-line | Colored header / topbar background, circle buttons, divider |
| --foot | Footer background |
| --page | Page background |
| --surface, --surface-2 | Card background, subtle background (inputs, tabs) |
| --line | Borders and dividers |
| --ink, --muted | Primary and secondary text |
| --accent | Positive accent (online dots, success) |
:root {
--brand-600: 0 103 178; /* primary color */
--head: 0 103 178; /* header background */
}
[data-theme='dark'] {
--brand-600: 96 165 250;
}Change the brand color by editing the --brand-* and --head* values, then run npm run build. The theme is applied before first paint by a small inline script in each page <head> (stored in localStorage["forumly-theme"], falls back to the system preference).
Typography & layout
- Font: Inter (variable, self-hosted, latin + latin-ext). Change
fontFamily.sansintailwind.config.jsand the@font-facerules insrc/css/input.css. - Site width: the
.container-sitecomponent (max 1440px, 16 / 24 / 40px side padding). Edit it insrc/css/input.css. - Breakpoints: Tailwind defaults — 640, 768, 1024, 1280, 1440px.
Logo & favicon
Files are in assets/img/: logo-light.svg (for dark / blue backgrounds), logo-dark.svg (for light backgrounds), logo-mark.svg, favicon.svg, favicon.ico, favicon-32.png, apple-touch-icon.png, icon-192.png, icon-512.png. Replace them with your own files of the same names. The wordmark is outlined (no font needed).
Components
Reusable component classes are defined in src/css/input.css:
| Class | Use |
|---|---|
.btn .btn-primary .btn-outline .btn-ghost | Buttons (height 40px; add !h-12 for larger) |
.icon-btn, .hdr-circle, .hdr-count | Round icon buttons and notification badges |
.tab-btn | Pill tab / filter button (aria-selected or aria-pressed sets the active state) |
.dropdown-panel, .menu-item | Dropdown / menu panels and items |
.avatar-img | Round avatar image |
.container-site | Centered 1440px container |
.main-link | Header navigation link with active underline |
A dropdown looks like this:
<div class="relative" data-dropdown>
<button type="button" aria-haspopup="true" aria-expanded="false"
aria-controls="my-menu" data-dropdown-toggle>Menu</button>
<div id="my-menu" class="dropdown-panel left-0 top-full mt-2 w-56 p-1.5" hidden>
<a href="#" class="menu-item">Item</a>
</div>
</div>JavaScript
All behavior is in assets/js/main.js (vanilla JS, ~25 KB unminified, loaded with defer). It is driven by data-* attributes, so no JavaScript has to be edited to use the components.
| Attribute | Description |
|---|---|
| data-dropdown | Wrapper of a dropdown. Needs a child [data-dropdown-toggle] with aria-controls pointing to the panel id. |
| data-hover | Add to [data-dropdown] to also open on mouse hover (fine pointers only). |
| data-drawer-open="#id" / data-drawer-close | Opens / closes the mobile drawer. |
| data-search-open / data-search-close | Opens / closes the search dialog (also Ctrl/⌘+K and /). |
| data-filter="all|top|…" | Filter buttons: show only .topic-row items whose data-tags contain the value. |
| data-tabs → data-tab / data-panel | Tab widget. Each [data-tab="x"] shows [data-panel="x"]; arrow keys supported. |
| data-accordion-toggle | Toggles the element referenced by aria-controls (uses the hidden attribute). |
| data-toggle-btn data-on="Label" | Stateful button (Subscribe / Follow). Text inside [data-label] changes. |
| data-like, data-vote, data-poll, data-shout, data-copy | Demo interactions: likes, vote arrows, poll, chat/message box, copy link. |
| data-countdown="ISO date" | Countdown timer with [data-cd="d|h|m|s"] elements. |
| data-theme-toggle | Switches light / dark theme (stored in localStorage["forumly-theme"]). |
| data-dismiss="#id" + data-dismissible | Dismissible announcement, remembered between visits. |
| body[data-auth="guest|member"] | Shows .guest-only or .member-only blocks. Demo: add ?auth=guest to any URL. |
Icons
Icons use the Phosphor icon font: <i class="ph ph-bell" aria-hidden="true"></i>. Size and color come from the surrounding text utilities (text-xl text-brand-600).
To keep pages light, assets/css/phosphor.css and assets/fonts/phosphor.woff2 contain only the icons used in this template. To use any other Phosphor icon, either link the complete set from assets/vendor/phosphor-full/ (replace the assets/css/phosphor.css link in your pages), or re-generate the optimized subset with python3 scripts/subset-icons.py (requires pip install fonttools brotli). Browse icons at phosphoricons.com.
Images
Avatars (assets/img/avatars/aNN.svg) and cover illustrations (assets/img/covers/cNN.svg) are vector files created for this template. Replace them with your own photos; keep the width and height attributes to avoid layout shift. Below-the-fold images use loading="lazy".
Accessibility
- Skip-to-content link, landmarks (
header,nav,main,footer) and oneh1per page. - Menus, dropdowns, tabs, accordions and dialogs are keyboard operable; Esc closes overlays; dialogs trap focus and restore it on close.
- Visible
:focus-visibleoutline on every interactive element. - Form fields have labels; icon-only buttons have
aria-label. prefers-reduced-motiondisables animations.- Text colors were checked against WCAG 2.1 AA contrast in both themes.
Browser requirements
The template uses CSS custom properties, :focus-visible, CSS grid and the individual translate / scale properties (used by the dropdown animation). These require a current evergreen browser: Chrome / Edge 104+, Firefox 72+ and Safari 14.1+. Internet Explorer is not supported.
Converting to WordPress / bbPress
This item is an HTML template. If you plan to build a bbPress theme from it, the Pages section lists the bbPress template each page corresponds to. Typical approach: split the header and footer into header.php / footer.php, register the menus with wp_nav_menu(), enqueue assets/css/style.css and assets/js/main.js, then copy each page body into the matching template. The .guest-only / .member-only blocks map to is_user_logged_in().
Credits & licenses
| Resource | License | Used for |
|---|---|---|
| Tailwind CSS 3.4 | MIT | Build-time CSS framework |
| Phosphor Icons 2.1 | MIT | Icon font |
| Inter 5.3 | SIL OFL 1.1 | Typeface |
| Avatars, covers, logo, favicons | Created by the author | Demo illustrations and branding |
License texts are in the licenses/ folder. See licenses/CREDITS.md for details. All demo names and content are fictional.
Changelog
1.0.0 — Initial release
- 5 homepage layouts and the full set of inner pages.
- Light / dark themes, responsive layouts, accessible patterns.
- Tailwind CSS 3 build, vanilla JavaScript, local fonts and icons.
Support & updates
Questions about the template? Use the item comments page or contact the author through the marketplace profile. Please include the page name, browser and a short description.