Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kjirou/minimum_javascript_on_rails
A Rails application that is set a minimal Node.js-based JavaScript build environment without webpacker
https://github.com/kjirou/minimum_javascript_on_rails
nodejs rails webpack webpacker
Last synced: 2 months ago
JSON representation
A Rails application that is set a minimal Node.js-based JavaScript build environment without webpacker
- Host: GitHub
- URL: https://github.com/kjirou/minimum_javascript_on_rails
- Owner: kjirou
- Created: 2019-10-05T01:42:45.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2021-08-31T07:29:29.000Z (over 3 years ago)
- Last Synced: 2023-03-30T12:33:05.776Z (over 1 year ago)
- Topics: nodejs, rails, webpack, webpacker
- Language: Ruby
- Homepage:
- Size: 135 KB
- Stars: 9
- Watchers: 3
- Forks: 0
- Open Issues: 4
-
Metadata Files:
- Readme: README.ja.md
Awesome Lists containing this project
README
# minimum_javascript_on_rails
- [README (English)](/README.md)
- [README (日本語)](/README.ja.md)
## :tipping_hand_woman: このアプリケーションは何か？
[webpacker](https://github.com/rails/webpacker) なしで Node.js ベースの最小の JavaScript ビルド環境を設定した、
Ruby on Rails アプリケーションのサンプルである。
もしあなたの Rails アプリケーションが以下の条件のいくつかに一致するならば、
このリポジトリの設定を使う方が保守性があがるかもしれない。
- 多くの JavaScript コードを含まない。
- スタイルシートのビルド環境は [sprockets-rails](https://github.com/rails/sprockets-rails) で十分だ。
- 使わない npm パッケージはインストールしない。
- 必要なパッケージを即座に更新できるようにするために、npm パッケージは可能な限り個別のものとして管理する。
- 開発者は webpacker より基礎的な JavaScript の知識を学びたいと思っている。
## :wrench: インストール
### ローカル環境へインストールが必要なソフトウェア
- [Ruby](https://www.ruby-lang.org/) == `2.6`
- [Node.js](https://nodejs.org/) == `10`
### このアプリケーションをインストールする
```
git clone [email protected]:kjirou/minimum_javascript_on_rails.git
bin/setup
```
## :cat: クライアントサイドへ追加された機能
- `npm run build`
- このコマンドは、スタンドアロンビルド用である。 主に本番リリースに使用する。
- `npm run watch`
- `npm run watch` が `rails server` と一緒に実行されている場合、
ブラウザをリロードするときに JavaScript ソースの変更が適用される。
- `npm run clean`
- `npm run build` または `npm run watch` によって生成されたファイルの削除。
## :gear: 設定のカスタマイズ
ひとつの設定を増やすと別の他の設定と連鎖して、総設定量が加速度的に増えてしまう。
そのため、このサンプルは本体の設定量は最小にして、プルリクエストの形式で設定のカスタマイズ例を表現することにした。
### ユニットテストを Node.js/Jest で動かす
- [参考プルリクエスト](https://github.com/kjirou/minimum_javascript_on_rails/pull/9)
### Babel から TypeScript へ変更する
- [参考プルリクエスト](https://github.com/kjirou/minimum_javascript_on_rails/pull/10)
### クライアントサイド専用の開発環境を作る
- (あとで書くかも？)
### CSS を Node.js でビルドする
- (あとで書くかも？)
### [Stimulus](https://github.com/stimulusjs/stimulus) を使う
- (あとで書くかも？)
### "Please execute `npm run build` command before operating the Rails." エラーを抑止する
- [参考プルリクエスト](https://github.com/kjirou/minimum_javascript_on_rails/pull/8)
### ビルドされた JavaScript ファイルのサイズを減少する
- すみません、詳しく知らない。
- 最初に "webpack chunk" とかでググると良さそう。