BuhoCMS is currently in Alpha. While most things should work as expected, bugs 🐛 are likely to exist. It is a good idea to backup 💾 your website folders just in case. Also, remember that many more features are planned ✨
A free and open source local CMS for Hugo static sites written in Flutter and Dart licensed under the GPLv3
BuhoCMS is a local Content Management System for static site generators like Hugo (support for others is planned for the future).
See BuhoCMS as a GUI for static site generators. Easily create or open a Hugo site, choose your Hugo theme and add your first posts. With BuhoCMS, adding and editing content is as easy as a few clicks. No more terminal commands, folder hunting or manual Front matter edits 🥳
BuhoCMS is made for... you 😃
...that is, everyone using Hugo as a static site generator who wants an easy to use, graphical way to edit content, so that you can make the best use out of the power of a static site generator: Creating and editing content.
BuhoCMS is for you if you land in at least one of the following categories:
- You already have a Hugo site and want to easily edit your content from now on
- You want to create a new Hugo site from zero with a graphical user interface
- You are a beginner looking for a simple way to begin your journey in using static site generators
- Currently supported platforms: Windows, Linux
- Planned: macOS, Web (possibly in the future)
Download and execute the BuhoCMS-Windows.exe file from the GitHub releases page.
macOS support is planned. Unfortunately I do not currently own a macOS device; to build and test BuhoCMS, a macOS device is needed.
- Supported: AppImage
- In progress: Flatpak (Flathub)
- Planned: Snap, .deb, AUR, .rpm
To install BuhoCMS as an AppImage, download the BuhoCMS-Linux.AppImage file from the GitHub releases page, make it executable and run it. For better desktop integration consider using AppImageLauncher.
- SSGs supported: Hugo
- Create or open a site
- Install Hugo themes for your site
- Add new posts and edit your Markdown content and Front matter with ease
- Edit content: Use the Markdown toolbar for quickly adding styles
- Markdown preview: Use the Markdown viewer to check your syntax
- Front matter: Graphical User Interface (GUI) for each field like a Text field, Switch, Date picker, Tag editor, and more
- Switch between GUI and raw text mode
- Start, open and stop your local Hugo server with a click
- Build your final Hugo site and open its "public" folder
- Privacy: BuhoCMS is a local program with no internet connection required – no ads, no tracking
- Free and open source: Licensed under the GPLv3
- Themes: Material Design with multiple color themes, both light and dark
- Fully responsive
- Multiple languages supported – Contribute translating your language!
- ...and many more features planned
These are the ways you can contribute to BuhoCMS:
Languages currently supported:
- English 🇬🇧
- German (Deutsch) 🇩🇪
First steps:
- If not already supported (see above), request a new language by opening an issue on GitHub and I will add the necessary code for the second step.
- Translate an already existing language (see below).
Translating guide: Weblate support is planned. For now, go to the .arb file of the language you want to translate (for example, app_de.arb file for German) and change the text inside the "" quotation marks. Use the English translation as a reference for the text to be translated to the target language. If the keys listed in the untranslatedMessages.txt don't exist, simply create them just like the others.
Send in your translated files as a Pull request
Open an issue on GitHub: Open issue. Remember to check for duplicates and try to give important information such as the app version, your operating system, etc.
Feel free to send in a pull request! To get started with Flutter, follow this link: https://docs.flutter.dev/get-started/install
- Clone this repository
- Switch to the project's directory and run
flutter pub getto get all necessary packages. To receive all localized strings, runflutter gen-l10n. To test the app, run the project in debug mode by selecting a device in your preferred Flutter IDE and running the app in debug mode - Build BuhoCMS (see steps for the different platforms below)
Windows executable: Run the following command in your terminal on a Windows machine: flutter build windows – the output file will be generated at buhocms\build\windows\runner\Release\buhocms.exe.
Linux executable: Run the following command in your terminal: flutter build linux – the output file will be generated atbuhocms/build/linux/x64/release/bundle.
General:
- Show terminal output
- Integration with git when "publishing" site (optional)
- Language filter for l10n
- Fix system light/dark color scheme
- Custom app theme colors
- Markdown Toolbar: "Add media" button for images for selecting an image
- Localization: Markdown Toolbar tooltip texts
- Configurable shortcuts
Hugo specific:
- Work with both hugo.* and config.* names (see Hugo Documentation)
- hugo/config.toml, hugo/config.yaml, hugo/config.json editor (+ create a .bak backup file)
- Hugo Archetypes editor
- Be able to delete themes and open the theme folder button
- Git-submodules for themes support
Project:
- Jekyll support
- More supported languages (See #translating above)
- Your features
The packages used for this app, also listed in the pubspec.yaml file. See their respective licenses.
| Package | Use case |
|---|---|
| context_menus | Right click context menus |
| convert | Convert json |
| dropdown_search | Add Front matter with a searchable Dropdown button |
| file_picker | Picking file paths |
| flex_color_scheme | App color schemes |
| flutter | Flutter SDK |
| flutter_localizations | Localization |
| flutter_markdown | Markdown preview |
| intl | Localization |
| markdown_toolbar | Markdown Toolbar |
| process_run | Run terminal commands |
| provider | State management for localization, themes, navigation, etc. |
| shared_preferences | Saving local app data, including settings |
| smooth_page_indicator | Page indicator in the onboarding screen |
| url_launcher | Open links in Browser |
| window_manager | Set minimum window size and window title |
This project is licensed under the GNU General Public License Version 3. For details, see LICENSE