Skip to content
Forumly

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.css

Tailwind 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.md

Pages

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

FilePagePlanned WordPress / bbPress template
index.htmlHome 1 — Classic: hero, forum cards, sidebar—
home-2.htmlHome 2 — Left sidebar, search hero, card grid—
home-3.htmlHome 3 — Centered, tabbed forums, no sidebar—
home-4.htmlHome 4 — Board table with fixed left menu—
home-5.htmlHome 5 — Magazine bento hero—

bbPress forum

FilePagePlanned WordPress / bbPress template
forums.htmlForum index — All forums by categoryarchive-forum.php · loop-forums.php
forum-single.htmlSingle forum — Subforums, topics and new topic formsingle-forum.php · loop-topics.php · form-topic.php
topics.htmlTopic archive — Latest / popular / no repliesbbPress views / topic archive · loop-topics.php
topic-single.htmlSingle topic — Replies, solution, reply formsingle-topic.php · loop-replies.php · loop-single-reply.php · form-reply.php
new-topic.htmlNew topic — Create topic form with editorform-topic.php ([bbp-topic-form])
topic-tag.htmlTopic tag — Topics for one tagtaxonomy-topic-tag.php
tags.htmlTags index — All tags[bbp-topic-tags]
search.htmlSearch results — Filters and highlightscontent-search.php · form-search.php
search-empty.htmlNo search results — Empty search statecontent-search.php (no results)
topic-edit.htmlEdit topic — Edit + merge / split toolssingle-topic-edit.php · form-topic-merge.php · form-topic-split.php
reply-edit.htmlEdit reply — Edit a reply with revision logsingle-reply-edit.php
topic-closed.htmlClosed topic — Locked topic statesingle-topic.php (closed state)
forum-empty.htmlEmpty forum — No topics yetfeedback-no-topics.php
no-access.htmlPrivate forum — No-access noticefeedback-no-access.php

Members

FilePagePlanned WordPress / bbPress template
members.htmlMembers — Directory with filtersplugin / BuddyPress member directory
profile.htmlProfile — Tabs: overview, topics, replies…user-profile.php · user-topics-created.php · user-replies-created.php · user-favorites.php · user-subscriptions.php
profile-edit.htmlEdit profile — Settings with tabsform-user-edit.php
leaderboard.htmlLeaderboard — Podium and rankingplugin (e.g. gamification)
notifications.htmlNotifications — Filterable listplugin (notifications)
messages.htmlMessages — Private messagesplugin (private messages)

Authentication

FilePagePlanned WordPress / bbPress template
login.htmlLog in — Split layoutform-user-login.php ([bbp-login])
register.htmlRegister — Create accountform-user-register.php ([bbp-register])
lost-password.htmlLost password — Reset linkform-user-lost-pass.php ([bbp-lost-pass])

Content & utility

FilePagePlanned WordPress / bbPress template
blog.htmlBlog — Posts archivehome.php / archive.php
blog-single.htmlBlog post — Article + commentssingle.php · comments.php
about.htmlAbout us — Story, values, teampage.php
contact.htmlContact — Form and info cardspage.php
faq.htmlHelp center / FAQ — Search + accordionspage.php
rules.htmlCommunity rules — Document templatepage.php
page.htmlGeneric page — Privacy / terms templatepage.php
404.html404 — Not found page404.php
maintenance.htmlMaintenance — Maintenance mode—
coming-soon.htmlComing soon — Countdown + email capture—

Homepage layouts

FileLayout
index.htmlClassic: three-row header, category cards, right sidebar
home-2.htmlLeft sidebar, search hero, two-column card grid
home-3.htmlCentered header, tabbed forum categories, no sidebar, widget row
home-4.htmlFixed left menu, classic board table, right widgets
home-5.htmlHeader 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.

VariablePurpose
--brand-50 … --brand-700Brand color scale (RGB triplets, e.g. 0 103 178)
--head, --head-2, --head-lineColored header / topbar background, circle buttons, divider
--footFooter background
--pagePage background
--surface, --surface-2Card background, subtle background (inputs, tabs)
--lineBorders and dividers
--ink, --mutedPrimary and secondary text
--accentPositive 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.sans in tailwind.config.js and the @font-face rules in src/css/input.css.
  • Site width: the .container-site component (max 1440px, 16 / 24 / 40px side padding). Edit it in src/css/input.css.
  • Breakpoints: Tailwind defaults — 640, 768, 1024, 1280, 1440px.

Components

Reusable component classes are defined in src/css/input.css:

ClassUse
.btn .btn-primary .btn-outline .btn-ghostButtons (height 40px; add !h-12 for larger)
.icon-btn, .hdr-circle, .hdr-countRound icon buttons and notification badges
.tab-btnPill tab / filter button (aria-selected or aria-pressed sets the active state)
.dropdown-panel, .menu-itemDropdown / menu panels and items
.avatar-imgRound avatar image
.container-siteCentered 1440px container
.main-linkHeader 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.

AttributeDescription
data-dropdownWrapper of a dropdown. Needs a child [data-dropdown-toggle] with aria-controls pointing to the panel id.
data-hoverAdd to [data-dropdown] to also open on mouse hover (fine pointers only).
data-drawer-open="#id" / data-drawer-closeOpens / closes the mobile drawer.
data-search-open / data-search-closeOpens / 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-panelTab widget. Each [data-tab="x"] shows [data-panel="x"]; arrow keys supported.
data-accordion-toggleToggles 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-copyDemo 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-toggleSwitches light / dark theme (stored in localStorage["forumly-theme"]).
data-dismiss="#id" + data-dismissibleDismissible 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 one h1 per page.
  • Menus, dropdowns, tabs, accordions and dialogs are keyboard operable; Esc closes overlays; dialogs trap focus and restore it on close.
  • Visible :focus-visible outline on every interactive element.
  • Form fields have labels; icon-only buttons have aria-label.
  • prefers-reduced-motion disables 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

ResourceLicenseUsed for
Tailwind CSS 3.4MITBuild-time CSS framework
Phosphor Icons 2.1MITIcon font
Inter 5.3SIL OFL 1.1Typeface
Avatars, covers, logo, faviconsCreated by the authorDemo 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.