/rails-dashboard

Primary LanguageJavaScriptMIT LicenseMIT

Rails Dashboard

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

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 by 1 row
k or move up by 1 row
space move down by 1 page
shift + space move up by 1 page
g move to top
shift + g move to bottom
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.

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