rails-dashboard

0.2.0 • Public • Published

Rails Dashboard

This application is dev-tool for rails, to improve your rails log.

demo

Breakdown View

demo

Params View

demo

ActiveRecords View

demo

demo

Renderings View

demo

(Raw) Log View

demo

Usage

$ npm install -g rails-dashboard
$ cd your/rails/project
$ rails-dashboard bin/rails s

# If you use npm 5.2 or higher
$ cd your/rails/project
$ npx rails-dashboard bin/rails s

and go to 'http://localhost:3000', then any operate.

Keymap

key desc
j or ↓ move down main-view by 1 row
k or ↑ move up main-view by 1 row
space move down main-view by 1 page
shift + space move up main-view by 1 page
g move to top
shift + g move to bottom
shift + j move down sub-view(currently [Log] tab only) by 1 row
shift + k move up sub-view(currently [Log] tab only) by 1 row
enter show detail about selected row
escape hide detail
b show detail with Breakdown tab
p show detail with Params tab
a show detail with ActiveRecord tab
r show detail with Rendering tab
l show detail with Log tab

Disclaimer

  • supported terminal application is Terminal.app, iTerm2.app and Hyper on Mac OS. (maybe works fine on Windows and Linux)
  • recommended terminal window size is 100 cols * 30 rows higher.
  • current supported Rails is version 5.1 and using Puma. but if there is no difference in format of the log, maybe works fine. If don't works fine, send the log to me please.

Troubleshooting

Not working to scroll in (long) log subview.

iTerm2.app

Try to run following command, and restart iTerm2.

$ defaults write com.googlecode.iterm2 AlternateMouseScroll -bool true

FYI: https://stackoverflow.com/a/24695541

Terminal.app

You'll need to allow mouse reporting. on menu [View] → [Allow Mouse Reporting].

Inspired by

  • RailsPanel : RailsPanel is a Chrome extension for Rails development that will end your tailing of development.log
  • webpack-dashboard : A CLI dashboard for your webpack dev server.
  • Tig : Tig is an ncurses-based text-mode interface for git.

Thanks!

Contributing

Pull requests and issues are always welcome.

For bugs and feature requests, please create an issue.

  1. Fork it!
  2. Create your feature branch: git checkout -b my-new-feature
  3. Commit your changes: git commit -am 'Add some feature'
  4. Push to the branch: git push origin my-new-feature
  5. Submit a pull request!

Development

(optional) Setup Rails app

  1. clone the Rails repository. $ git clone https://github.com/y-takey/dmy-rails
  2. setup. $ cd dmy-rails && bundle && bin/rails db:migrate

Setup

  1. clone this repository. $ git clone https://github.com/y-takey/rails-dashboard.git
  2. npm install. $ cd rails-dashboard && yarn install # or npm install

Run

$ cd your/rails/project/path  # e.g. cd dmy-rails
$ NODE_ENV=dev ../rails-dashboard/node_modules/.bin/babel-node ../rails-dashboard/bin/rails-dashboard.js bin/rails s

# or to generate dummy request, use this
$ NODE_ENV=dmy ../rails-dashboard/node_modules/.bin/babel-node ../rails-dashboard/bin/rails-dashboard.js bin/rails s

Package Sidebar

Install

npm i rails-dashboard

Weekly Downloads

1

Version

0.2.0

License

MIT

Last publish

Collaborators

  • y-takey