Ruby On Go
Welcome to Ruby On Go ~ a webshop framework.
NOTE: This is still alpha software. It's under construction, but if you love this idea, please check back soon or join team kitschmaster and contribute!
Install the framework:
$ gem install rubyongo
Please also install the static site generator Hugo:
You should now be able to run
rog the Ruby On Go CLI.
Quick start usage
Create a new website:
$ rog new domain.name
This will generate a new Ruby On Go webshop in the subdirectory
The folders are very similar to a regular Hugo static site template. They include a
panel folder for the ruby Panel UI, which is also the place where you write your Ruby microservices.
The three config files
You shall notice these config files:
- panel.yml ~ ruby microservice backend + Panel UI settings
- config.ru ~ only needed for Rack type deployment
- config.toml ~ static site config (Hugo), editable through the Panel UI
Write tests in the test folder and run them with:
$ rake test
Developing a site
Start the Panel UI + backend app (Sinatra):
$ rog s
localhost:9393 to see the panel, edit content...
Start the static site server (Hugo):
$ rog h
localhost:1313 to see the static site.
Deploying static, serving dynamic
Ruby On Go is designed to "run fast by default", even in cheap memory-poor environments, like shared hosting. It cuts down on deployment costs by staying fully static on the frontend, highly deployable, yet allowing adding microservices at the backend with very little effort.
- go 1.6
- ruby 1.9
- the host needs to support running Ruby Rack.
- Hugo, the static site generator is a dependency currently and is used as the default static site generator.
- (optional) the host needs to support running go web apps (for example on Dreamhost this is achieved by FCGI). In case you want to run go microservices next to the ruby microservices.
Deployment system commands
sys contains Ansible playbooks and bash scripts to allow setting up domains and deploy to them.
After checking out the repo, run
bin/setup to install dependencies. Then, run
rake test to run the tests. You can also run
bin/console for an interactive prompt that will allow you to experiment.
To build the gem run
To install this gem onto your local machine, run
bundle exec rake install. To release a new version, update the version number in
ROG_VERSION, and then run
bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the
.gem file to rubygems.org.
Bug reports and pull requests are welcome on GitHub at https://github.com/kitschmaster/rubyongo. 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.
The gem is available as open source under the terms of the MIT License.