Shadowgraph
TrendingAbout
Sign in

picoruby/funicular

Rails plugin for full-stack SPA in Ruby

Ruby

42

180 commits

updated Sep 17, 2026

picoruby.org/funicular

See the code

README

Funicular

🎡Funicu-lì, Funicu-là!🚊🚊🚊

🎡Funicu-lì, Funicu-là!🚞🚞🚞

Funicular is a single-page application (SPA) framework powered by PicoRuby.wasm.

Features

  • Write client-side code in Ruby instead of JavaScript
  • Seamless Rails integration

Combined Gem

This repository consists of three relevant projects:

  • PicoGem "picoruby-funicular" ... Core implementation
  • CRubyGem "funicular" ... Rails integration
  • Chrome extension "PicoRuby Debugger"

PicoGem "picoruby-funicular"

.
β”œβ”€β”€ mrbgem.rake
β”œβ”€β”€ mrblib/
└── test/

CRubyGem "funicular"

.
β”œβ”€β”€ bin/
β”œβ”€β”€ exe/
β”œβ”€β”€ funicular.gemspec
β”œβ”€β”€ Gemfile
β”œβ”€β”€ Gemfile.lock
β”œβ”€β”€ lib/
β”œβ”€β”€ minitest/
└── Rakefile

Chrome extention "PicoRuby.wasm debugger"

.
└── debugger/

The others are common resources.

Documentation

User documentation is hosted on picoruby.org:

  • Getting Started with Funicular β€” a standalone, no-Rails tutorial
  • Funicular on Rails β€” quick tutorial, installation, the asset pipeline, and a feature-by-feature tutorial plus reference (components, routing, forms and validation, data fetching, stores, SSR, styling, debugging)

For contributors working on the gem itself, see docs/architecture.md.

Development

This repository is a submodule of picoruby/picoruby. Do not check it out as a standalone. Instead, clone the parent repository and work from there:

git clone --recurse-submodules https://github.com/picoruby/picoruby.git
cd picoruby/mrbgems/picoruby-funicular

The CRubyGem side (lib/, funicular.gemspec, etc.) can be developed and tested independently inside that directory, but rake copy_wasm β€” which vendors the PicoRuby.wasm and mrbc wasm artifacts into the gem β€” relies on sibling directories within the picoruby repository (mrbgems/picoruby-wasm/npm/). Running it from a standalone checkout will fail.

Testing

  • CRubygem (Rails integration) test: rake test in this repository
  • PicoGem Funicular test: rake test:gems:wasm[picoruby-funicular] in picoruby where mrbgems/picoruby-funicular exists as a submodule

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/picoruby/funicular.

License

Copyright Β© 2025- HASUMI Hitoshi. See MIT-LICENSE for further details.

Contributors

hasumikin

177 commits

atzzCokeK

1 commits

mjq

1 commits

ydah

1 commits

Similar repos

picoruby/picoruby

PicoRuby is the smallest Ruby implementation for one-chip microcontrollers

1,104

same org

picoruby/R2P2

PicoRuby shell for Raspberry Pi Pico (RP2040)

137

same org

shakacode/react_on_rails

Integration of React + Webpack + Rails including server-side rendering of React, enabling a better…

5,189

hanami/hanami

A flexible framework for maintainable Ruby apps

6,413

shakacode/shakapacker

Use Webpack to manage app-like JavaScript modules in Rails

488

markets/awesome-ruby

πŸ’Ž A collection of awesome Ruby libraries, tools, frameworks and software

14,157

shakacode/react_on_rails_tutorial_with_ssr_and_hmr_fast_refresh

Reference tutorial app for React on Rails with SSR, Fast Refresh HMR, and Shakapacker/Webpack.

94

shakacode/react_on_rails_demo_ssr_hmr

Reference tutorial app for React on Rails with SSR, Fast Refresh HMR, and Shakapacker/Webpack.

94

Languages

Ruby

97.8%

JavaScript

1.9%

picoruby/funicular

Rails plugin for full-stack SPA in Ruby

Ruby

42

180 commits

updated Sep 17, 2026

picoruby.org/funicular

See the code

README

Funicular

🎡Funicu-lì, Funicu-là!🚊🚊🚊

🎡Funicu-lì, Funicu-là!🚞🚞🚞

Funicular is a single-page application (SPA) framework powered by PicoRuby.wasm.

Features

  • Write client-side code in Ruby instead of JavaScript
  • Seamless Rails integration

Combined Gem

This repository consists of three relevant projects:

  • PicoGem "picoruby-funicular" ... Core implementation
  • CRubyGem "funicular" ... Rails integration
  • Chrome extension "PicoRuby Debugger"

PicoGem "picoruby-funicular"

.
β”œβ”€β”€ mrbgem.rake
β”œβ”€β”€ mrblib/
└── test/

CRubyGem "funicular"

.
β”œβ”€β”€ bin/
β”œβ”€β”€ exe/
β”œβ”€β”€ funicular.gemspec
β”œβ”€β”€ Gemfile
β”œβ”€β”€ Gemfile.lock
β”œβ”€β”€ lib/
β”œβ”€β”€ minitest/
└── Rakefile

Chrome extention "PicoRuby.wasm debugger"

.
└── debugger/

The others are common resources.

Documentation

User documentation is hosted on picoruby.org:

  • Getting Started with Funicular β€” a standalone, no-Rails tutorial
  • Funicular on Rails β€” quick tutorial, installation, the asset pipeline, and a feature-by-feature tutorial plus reference (components, routing, forms and validation, data fetching, stores, SSR, styling, debugging)

For contributors working on the gem itself, see docs/architecture.md.

Development

This repository is a submodule of picoruby/picoruby. Do not check it out as a standalone. Instead, clone the parent repository and work from there:

git clone --recurse-submodules https://github.com/picoruby/picoruby.git
cd picoruby/mrbgems/picoruby-funicular

The CRubyGem side (lib/, funicular.gemspec, etc.) can be developed and tested independently inside that directory, but rake copy_wasm β€” which vendors the PicoRuby.wasm and mrbc wasm artifacts into the gem β€” relies on sibling directories within the picoruby repository (mrbgems/picoruby-wasm/npm/). Running it from a standalone checkout will fail.

Testing

  • CRubygem (Rails integration) test: rake test in this repository
  • PicoGem Funicular test: rake test:gems:wasm[picoruby-funicular] in picoruby where mrbgems/picoruby-funicular exists as a submodule

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/picoruby/funicular.

License

Copyright Β© 2025- HASUMI Hitoshi. See MIT-LICENSE for further details.

Similar repos

picoruby/picoruby

PicoRuby is the smallest Ruby implementation for one-chip microcontrollers

1,104

same org

picoruby/R2P2

PicoRuby shell for Raspberry Pi Pico (RP2040)

137

same org

shakacode/react_on_rails

Integration of React + Webpack + Rails including server-side rendering of React, enabling a better…

5,189

hanami/hanami

A flexible framework for maintainable Ruby apps

6,413

shakacode/shakapacker

Use Webpack to manage app-like JavaScript modules in Rails

488

markets/awesome-ruby

πŸ’Ž A collection of awesome Ruby libraries, tools, frameworks and software

14,157

shakacode/react_on_rails_tutorial_with_ssr_and_hmr_fast_refresh

Reference tutorial app for React on Rails with SSR, Fast Refresh HMR, and Shakapacker/Webpack.

94

shakacode/react_on_rails_demo_ssr_hmr

Reference tutorial app for React on Rails with SSR, Fast Refresh HMR, and Shakapacker/Webpack.

94

Contributors

hasumikin

177 commits

atzzCokeK

1 commits

mjq

1 commits

ydah

1 commits

Languages

Ruby

97.8%

JavaScript

1.9%