Skip to content

hyperstack-org/hyperstack

Repository files navigation

Hyperstack

Build Status Gem Version License: MIT Slack

Hyperstack is a Ruby-based DSL and modern web toolkit for building spectacular, interactive web applications fast!

  • One language throughout the client and server. All Ruby code is compiled by Opal into JavaScript automatically.
  • Webpacker and Yarn tooling for a modern, fast hot-reloader build environment with Ruby source maps.
  • A well documented and stable Ruby DSL for wrapping React and ReactRouter as well as any JavaScript library or component. No need to learn JavaScript!
  • Isomorphic Models with bi-directional data so you can access your models as if they were on the client.

This means you can write simple front-end code like this:

class GoodBooksToRead < HyperComponent
  render(UL) do
    Book.good_books.each do |book|
      LI { "Read #{book.name}" }
        .on(:click) { display book } if book.available?
    end
  end
end

In the code above, if the good_books scope changed (even on the server), the UI would update automatically. That's the magic of React and Isomorphic Models with bi-directional data at work!

Website and documentation

Please see the website site for full documentation:

Setup and installation

You can be up and running in less than 5 minutes. Just follow the simple setup guide for to add Hyperstack to a new or existing Rails application:

Development Status

We now are issuing 1.0 release candidates weekly until all issues are either closed or moved to post 1.0 release status. Your opinion matters, plus take some time to up/down vote or comment on issues of interest.

Release
Date
Version Open
Issues
Documentation
Sections
Draft Ready
Documentation
Sections
WIP
April 12, 2021 1.0.alpha1.8 128 36 9

Open issues includes enhancements, documentation, and discussion issues as well as few bugs.

The documentation WIP (work in progress) numbers are approx, as more sections may be added.

Community and support

Hyperstack is supported by a friendly, helpful community, both for users, and contributors. We welcome new people, please reach out and say hello.

StackOverflow Questions

Please ask technical questions on StackOverflow as the answers help people in the future. We use the hyperstack tag, but also add ruby-on-rails, ruby and react-js tags to get this project exposed to a broader community.

Contributing

If you would like to help, please read the CONTRIBUTING file for suggestions.

License

Released under the MIT License. See the LICENSE file for further details.