One of the things I get asked about most is how far you can take ForumSpark when it comes to making it your own. So I wanted to put together a proper rundown of what's possible today, where the limits are, and what we're working toward.
Themes
The theme system is probably the most powerful tool you have right now.
Every board comes with a full theme editor in the AdminCP. You have access to over 100 CSS variables that control everything from background colors and fonts to panel borders, link styles, and dark mode. You can write your own custom CSS on top of that, and if you really want full control, there's a layout template editor where you can restructure the actual HTML of your board.
Themes can be exported and imported as JSON files. That means you can build something, share it with someone else, and they can install it in seconds. This also makes it easy to back up your work or move a design between boards.
If you toggle off "Inherit Default Styles", your theme runs completely standalone. No Tailwind, no default CSS. Just your own styles and the theme variables. This is useful if you're building something from scratch and don't want any interference.
For most people, keeping inheritance on and customizing through the editor and custom CSS is the easiest path. But the option is there if you want to go deeper.
Widgets
Widgets let you add content blocks to different areas of your board - header, sidebar, below the board, profile pages, footer, and more.
There are a bunch of built-in ones: announcements, recent activity, online users, shoutbox, board statistics, upcoming birthdays, latest blog entries, and others. But you can also create your own custom widgets using HTML templates and a configuration schema. That means you can build reusable content blocks with settings.
It's not full application logic, but for things like embedded content, custom announcements, promotional blocks, or third-party widget embeds, it works well.
The API
This is where things get interesting for anyone with a bit of technical knowledge.
ForumSpark has a REST API that covers the core of the platform: forums, topics, replies, users, groups, and themes. Authentication is token-based, so you can build external tools that interact with your board securely.
On top of that, we have webhooks. You can subscribe to events and have ForumSpark send signed payloads to your own endpoints whenever something happens. This opens the door to things like Discord bots that announce new topics, external moderation tools, analytics dashboards, or syncing content to other platforms.
Full documentation is available at https://docs.forumspark.net/api/.
JavaScript Extensions
This is something that's not immediately obvious, but it's already possible and quite powerful.
Through the layout template editor or a Raw HTML widget, you can inject custom JavaScript into your board. And with JS you can do a lot more than people realize - you can interact with the page, add toolbar buttons, transform content, embed external services, and build real features on top of what's already there.
A good example: one of our members built a video embed extension entirely with JavaScript. It adds an "Insert Video" button to the editor toolbar, lets you pick from Dailymotion, Facebook, TikTok, Twitch, or Vimeo, paste a URL, and it gets embedded directly into the post. On the reading side, it parses the custom tags and renders the actual video players inline. All done with a script block - no server-side changes needed.
That's the kind of thing you can build today. Some other ideas that work the same way:
Toolbar buttons that insert formatted content or templates
External embeds like live stream status, social feeds, or maps
Visual enhancements like reading progress bars, "back to top" buttons, or image lightboxes
Live indicators like typing notifications or online badges
Anything that talks to an external API and renders results on the page
You have full access to the DOM, you can use the existing panel and button classes for a consistent look, and because the script runs in the browser, there's no limit on what external services you can connect to.
It's not a formal plugin system, and it does require JavaScript knowledge, but for anyone comfortable with JS, there's genuinely a lot you can accomplish right now.
What's Limited
I want to be upfront about this.
ForumSpark is a hosted platform. You don't have server access, and you can't upload PHP files or modify core behaviour the way you might with self-hosted software like XenForo or Invision. That's by design - it's what allows us to keep things stable, secure, and maintained for everyone without the overhead of managing your own server.
Right now, you can't add new pages or routes through an extension, you can't hook into internal events from outside the platform, and there's no way to add custom editor extensions or modify how posts are rendered. Widgets are template-based, so they can't run server-side logic or fetch external data on their own.
These are real limitations, and I'm not going to pretend otherwise. Is this something we're looking into improving? Definitely.
What's Coming
This is something I've been thinking about a lot, and we're actively working toward a proper extension ecosystem.
The first step is a Theme & Widget Directory inside the AdminCP. Instead of manually importing JSON files, you'll be able to browse a directory of community-created themes and widgets and install them with one click. There will also be a submission and review process so creators can share what they've built.
Beyond that, we're working on an App Framework - a way for developers to build external integrations that plug into ForumSpark more deeply. Think of it like how apps work on platforms like Shopify: an app connects to your board through the API, can subscribe to events via webhooks, and can inject its own scripts into your forum pages. No PHP uploads, no security risks, but much more capable than what we have today.
We're also looking at giving widgets access to forum data through safe template variables, expanding the number of webhook events, and adding custom script injection points so you can load third-party tools without needing to touch the layout templates.
And eventually, proper developer documentation with guides for building themes, widgets, and apps from start to finish.
This is coming very soon! We want ForumSpark to be a platform you can build on - not just use as-is.
As always, feedback is welcome. If there's a specific integration or customization you're struggling with today, let me know in the support forum. It helps us prioritize.
