Project

discourse_theme

0.03
A long-lived project that still receives updates
discourse_themediscourse/discourse_themeHomepageDocumentationSource Code
CLI helper for creating Discourse themes
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Popularity
Downloads
59,943
Stars
37
Forks
13
Watchers
21
 Releases
Current version
2.1.3
Total releases
44
First release
2018-03-14
Latest release
2024-10-08
 Pull Requests
Open Pull Requests
0
Closed Pull Requests
5
Merged Pull Requests
42
Pull Request Acceptance Rate
89%
 Development
Primary Language
Ruby
Licenses
MIT
Average date of last 50 commits
2022-07-18
Reverse Dependencies
0

 Dependencies

Development

bundler
>= 0
guard
>= 0
guard-minitest
>= 0
minitest
>= 0
rake
>= 0
rubocop-discourse
~> 3.8.1
m
>= 0
webmock
>= 0
mocha
>= 0
syntax_tree
>= 0

Runtime

listen
~> 3.1
minitar
~> 0.6
multipart-post
~> 2.0
rubyzip
~> 2.3
tty-prompt
~> 0.18
selenium-webdriver
> 4.11
 Project Readme

Discourse Theme

This CLI contains helpers for creating Discourse themes and theme components.

Installation

To install the CLI use:

$ gem install discourse_theme

Why this gem exists?

This gem allows you to use your editor of choice when developing Discourse themes and theme components. As you save files the CLI will update the remote theme or component and changes to it will appear live!

Usage

For help run:

discourse_theme

discourse_theme new PATH

Creates a new blank theme. The CLI will guide you through the process.

discourse_theme download PATH

Downloads a theme from the server and stores in the designated directory.

discourse_theme watch PATH

Monitors a theme or component for changes. When changed the program will synchronize the theme or component to your Discourse of choice.

discourse_theme upload PATH

Uploads a theme to the server. Requires the theme to have been previously synchronized via watch.

discourse_theme rspec PATH

Runs the RSpec system tests under the spec folder in the designated theme directory.

On the first run for the given directory, you will be asked if you'll like to use a local Discourse repository to run the tests.

If you select 'Y' and proceeds to configure the path to the local Discourse repository, the tests will be ran using the local Discourse development environment provided by the local Discourse repository. Note that you'll have to set up the local test environment before the tests can be ran successfully.

If the 'n' option is selected, the tests will run in a Docker container created using the discourse/discourse_test:release Docker image. Note that this requires Docker to be installed.

When the --headless option is used, a local installation of the Google Chrome browser is required.

Run discourse_theme --help for more usage details.

Contributing

Bug reports and pull requests are welcome at Meta Discourse. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.

License

The gem is available as open source under the terms of the MIT License.

Code of Conduct

Everyone interacting in the DiscourseTheme project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the code of conduct.