---

📣 The Announcement

Supporting our extension ecosystem in building even more awesome extensions, is something we firmly believe in. As such @askvortsov has been hammering away at this project (RFC: Flarum CLI Alpha, Flarum CLI Dev Diary), setting up a solid foundation for it to create a powerful tool for extension development that would help developers by automating some repetitive and menial tasks, and allow them to get into the actual work without much hassle.
Today, we're very excited to announce the 1.0 version of this tool, it comes with a range of commands to assist you along the way.

---

📥 Installation

Using npm simply run the following command to install the CLI globally.
If you have the alpha version installed, remove it first:

$ npm uninstall -g flarum-cli

Now install the new package:

$ npm install -g @flarum/cli

To run a command, use either flarum-cli or fl:

$ flarum-cli COMMAND
$ fl COMMAND

To see a list of available commands, run either of:

$ flarum-cli
$ flarum-cli --help

---

⬆️ Updating

$ npm update -g @flarum/cli

---

🌟 Highlights

The CLI has different types of commands for different tasks:
Initialisation

• flarum-cli init [PATH]: Generates a blank extension skeleton, including all recommended infrastructure.

Infrastructure

• flarum-cli infra backend-testing [PATH]: Adds (or updates) infrastructure for running automated backend tests.

Backend Boilerplate Generation: Generates different types of backend classes and/or extenders, ready to be used.

• flarum-cli make backend api-controller [PATH]
• flarum-cli make backend api-serializer [PATH]
• flarum-cli make backend api-serializer-attributes [PATH]
• flarum-cli make backend command [PATH]
• flarum-cli make backend event-listener [PATH]
• flarum-cli make backend handler [PATH]
• flarum-cli make backend integration-test [PATH]
• flarum-cli make backend job [PATH]
• flarum-cli make backend migration [PATH]
• flarum-cli make backend model [PATH]
• flarum-cli make backend policy [PATH]
• flarum-cli make backend repository [PATH]
• flarum-cli make backend route [PATH]
• flarum-cli make backend service-provider [PATH]
• flarum-cli make backend validator [PATH]

Frontend Boilerplate Generation: Generate frontend components/classes, ready to be used.

• flarum-cli make frontend component [PATH]
• flarum-cli make frontend modal [PATH]
• flarum-cli make frontend model [PATH]

Code Updates:

• flarum-cli update js-imports [PATH]: Adds admin/forum/common namespaces to all JS imports from flarum core.

And of course, you can always use the help command to see a list of all available commands with their descriptions:

• flarum-cli help [COMMAND]

---

🔥 The Most Powerful Commands

Of all the aforementioned commands, the two most powerful ones that will make a huge difference, are the extension initialisation command and the backend model generation command. The former obviously allows to kickstart the extension with the recommended skeleton from the Core Dev team, while the latter not only creates the backend model, it allows to create all the classes related to the model, from just its name:

• Table migration
• Policy
• API Serializer
• CRUD API Controllers
• CRUD Handlers
• Repository
• Validator
• Routes
• Related Extenders

🧑‍🏭 Support & Feedback

If you encounter any problems while using the CLI, or would like to propose additional features/commands, please open an issue in the github repository.
Any and all feedback is appreciated.

Links

• GitHub
• npm

v1.2.0 - Quokka

---

📣 The Release

---

Yet another year has gone by, and another year has come, the Flarum team wishes a happy new year to all of you flarumites 🎉, and may 2022 be another exciting year for the project.
And with all the recent festivities, Flarum also comes bearing a gift! we are very happy to announce the release of Flarum v1.2 which contains more than 240 commits 🤯, made up of bug squashes, performance improvements, accessibility fixes, and some nice feature additions. With over 105 issues closed on the milestone, this is Flarum's second biggest release to date. Let's see some highlights:

• 📑 You can now view README documentation on an extension page (flarum/core#3094).
• 🎨 Color inputs in the appearance page display a preview of the chosen color (flarum/core#3140).
• 🏷️ Users with permission to bypass tag requirements can now toggle the behavior through the UI (flarum/tags#153).
• ⌨️ New users are now prompted for a nickname on registration (flarum/nicknames#4).
• 👮 Suspended users are now shown their suspension details on their first visit (flarum/suspend#41).
• 📬️ Total rewrite of Akismet, adding PHP8 compatibility, permission to bypass Akismet, a config option to immediately delete blatant spam, and other new features.
• ♿ Fixed multiple accessibility issues (flarum/core#3090, flarum/core#3161, flarum/core#3207, flarum/core#3018, flarum/core#3018, flarum/core#3173, flarum/core#3237).
• ✨ The CSS codebase now uses flexible CSS custom properties (flarum/core#3146).
• ⚙️ Introduced a default settings extender to replace migration-based defaults (flarum/core#3127).
• 🗃️ Developers can now replace blade template namespaces via a new extender (flarum/core#3167).
• 🪝 Introduced registering settings as Less config variables through the settings extender (flarum/core#3011).
• 🐛 Many bugs were squashed.
• 🚅 Performance was further improved.
• 🧑‍💻 And much much more...

👨‍💻 For Developers

---

Most extensions should be ready-to-go on Flarum 1.2 out of the box. If you're overriding component views, directly manipulating the DOM, or changing core behavior through service providers you might need to implement some minor changes in some areas, here are some key points:

• For theming, we have now fully switched to using CSS custom properties. It is advised to declare your additional variables, especially colors as CSS custom properties and use them, for an easier transition to 2.0. Check out the pull request for more info.
• The evented util is now deprecated (flarum/core#2547).
• Pushing unregistered models to the store is now deprecated (flarum/core#3206).
• Providing models as attributes to Model.pushData() or Model.pushAttributes() is deprecated (flarum/core#3249).

⤴️ Upgrading

---

Before you upgrade, make sure to create a backup of your public/assets directory, your composer.json and your database!

Before starting the upgrade process, ensure you are on Flarum 1.0.0 or above in your Admin Dashboard or by typing php flarum info. If you're not, use the previous release notes for upgrading from an earlier version.
To upgrade from 1.0 or 1.1 to 1.2, take a look at our upgrade guide documentation. The process should be much easier compared to previous major version upgrades, due to the lack of breaking changes.

If you run into any issues, please open a new discussion under the Support tag. Ignore similar discussions, and open a new one anyhow. Make sure to mention the output of php flarum info, composer why-not flarum/core v1.2.0, and any errors to their fullest.

🙇‍♀️ Acknowledgements

---

Flarum wouldn't be the same without our over one hundred contributors, along with their generous time commitments! For this release we specifically thank these wonderful people:

• Code Contributors: @Kylo @clarkwinkelmann @ianm @rafaucau, sergiy-petrov, Braunson, wotta, mbicknese, fransiscusrolandamalau, MatusMak, fredden, grimmdude, komandar, doceazedo.
• Eagle-eyed issue reporters: @rob006, @Hari, @franga2000, purplespider, @rafaucau, HandyMenny, @Justoverclock, @Darkle, @Markiemm, Greazi-Times, obfuscatedgenerated, @Nearata.
• Documentation contributions: @datlechin.
• Core Developers: @askvortsov @SychO @davwheat @datitisev @tankerkiller125 @luceos
• Quality Assurance: @katos @Deebug @ianm
• Community Staff: @jordanjay29 @meetdilip @Prosperous @Pollux @Kyrne
• Translation team: @GreXXL @Justoverclock @rob006
• Everyone who's submitted carefully described issues and suggestions.
• And the whole community sharing their passion for Flarum, urging us on!

🆘 Support the Project

---

We need your support to:

• Guarantee continued development on the software.
• Create a valuable ecosystem around the project.
• Ensure healthy extensions are available.

You can support us:

• 👕 By getting some swag from our merchandise store!
• 💵 By backing us on Open Collective or on GitHub.
• 👩‍💻 By contributing to the source code, hop onto any of our open issues.
• 📈 By creating your own Flarum extensions and sharing them with the world!
• 🌎 By translating Flarum and extensions into your own language.
• 💝 By sharing your love for Flarum with friends, family and on the internet.
• 💬 By hanging out with us, here on discuss!

If you're looking to get coding, make sure to check out our documentation.

🔮 What now?

---

As with every new release, stay tuned for potential patch releases, we will also very soon release our brand new revamped roadmap for v2.0 🚀.

This discussion acts as a way for people to subscribe to announcements on releases. Before stable we would announce releases as separate discussions, because all changes were bundled and released as one beta.
Having passed that milestone we have already released several patch releases for v1.0. These releases were announced either in the v1.0 release announcement or in the Dev Diary. We felt this is not the right place.
From now on we will announce ALL releases, no matter the size, in this discussion. 🔔 So make sure to follow.

• ⏰ Releases for Flarum and all bundled extensions are announced here and/or linked to.
• 🔇 Comments are disabled. Please open a discussion for feedback or support.

Previous Release Announcements

• Flarum 1.0.0 Released
• Flarum 1.0.1 Released - minor patches
• Critical security update to Flarum core, with new incident write-up (v1.0.2)

Here we go again 😉
v1.2.0 was just released, let's continue keeping you all in the loop about our progress as much as we can.

v1.1 was just released 🥳
Time for a new dev diary, with the hopes of making this a bit more active than the last one 👍️