svelte-on-rails 0.0.45 → 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/README.md +25 -14
- metadata +1 -1
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: af9b4125161ea52c5785989db9e7f4b250a4bbe993f49264403680c5aa5467fb
|
4
|
+
data.tar.gz: 1d21a733aa52d57f892159baeb88c162cb78f46fca648dd2f31b45e3db8819e0
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 72c0797453be3020409b6e28f5b7f472e8e0c1a22e010c401925ad2a81ac360c522612a7e52bac3d7a8da5a4c51f62668a68d46a33b3a955ed9e072366a567fd
|
7
|
+
data.tar.gz: 7f377d2c359daa8a9a2e18cd7c147187dd4249bbd0a8b5987f0feddb4a7b72020bc49591e04502055e4a7223e78e05b8e832c21c345dc93ac1d943440587dfc0
|
data/README.md
CHANGED
@@ -17,8 +17,8 @@ Thanks to [shakacode](https://github.com/shakacode/react_on_rails)
|
|
17
17
|
and [ElMassimo](https://github.com/ElMassimo) for inspiring and helping me with their gems.
|
18
18
|
|
19
19
|
**STATUS** This gem is in early development but ready to use for curious developers.
|
20
|
-
It has a 100% test coverage, all tests pass
|
21
|
-
|
20
|
+
It has a 100% test coverage, all tests pass.
|
21
|
+
It is not yet implemented on my customer projects, but this will follow soon.
|
22
22
|
|
23
23
|
If you have issues, please open one and contributors are welcome!
|
24
24
|
|
@@ -34,9 +34,7 @@ If you have issues, please open one and contributors are welcome!
|
|
34
34
|
|
35
35
|
## Installation from cero
|
36
36
|
|
37
|
-
|
38
|
-
|
39
|
-
If you want to start from a new rails app, follow theese tutorials
|
37
|
+
With haml, vite, svelte and turbo:
|
40
38
|
|
41
39
|
```bash
|
42
40
|
rails new my-test-app --skip-javascript
|
@@ -75,14 +73,17 @@ And there is the option `--force` that would not ask you whether it should overw
|
|
75
73
|
This means, if you want all, except haml, you can run:
|
76
74
|
|
77
75
|
```bash
|
78
|
-
rails g svelte_on_rails:install --vite --turbo --svelte --hello-world
|
76
|
+
rails g svelte_on_rails:install --vite --turbo --svelte --hello-world
|
79
77
|
```
|
80
78
|
|
81
|
-
The installer is written carefully: It does not overwrite a file without asking
|
82
|
-
|
79
|
+
The installer is written carefully: It does not overwrite a file without asking
|
80
|
+
and tells you all what he is doing.
|
83
81
|
|
84
82
|
At the end, you just have to (re-) start your server
|
85
|
-
and you will see a Svelte component.
|
83
|
+
and you will see a Svelte Hello World component.
|
84
|
+
|
85
|
+
This hello world has a second page where the most common import statements are demonstrated,
|
86
|
+
separated for server and client side rendering.
|
86
87
|
|
87
88
|
Then, you can run
|
88
89
|
|
@@ -120,12 +121,13 @@ Both should return the same html. And your global styles should be applied same
|
|
120
121
|
for both cases. For 95% of use cases this is the case.
|
121
122
|
|
122
123
|
For check the **ssr pipeline** you can pass the options `ssr: true` and `hydrate: false`
|
123
|
-
to the view helper.
|
124
|
+
to the view helper. This way you will see a «dead» html (no javascript is working).
|
124
125
|
|
125
126
|
For check the **client side pipeline** you can pass the option `ssr: false` and
|
126
127
|
`hydrate: true` to the view helper.
|
127
128
|
|
128
|
-
If both are looking similar, you are good to go.
|
129
|
+
If both are looking similar, you are good to go. Then, remove theese options, the defaults are
|
130
|
+
`ssr: :auto` and `hydrate: true`.
|
129
131
|
|
130
132
|
### Import statements
|
131
133
|
|
@@ -191,19 +193,28 @@ rails svelte_on_rails:remove_hello_world
|
|
191
193
|
|
192
194
|
Contributors welcome!
|
193
195
|
|
194
|
-
|
196
|
+
**Download the code and run the tests**
|
197
|
+
|
198
|
+
Download the source code from the repository, and within the project folder run:
|
195
199
|
|
196
200
|
```bash
|
197
201
|
rake svelte_on_rails:create_contributor_configs_file
|
198
202
|
```
|
199
203
|
and define a `generated_test_app_folder_path` (required) for apps, generated for the testings.
|
200
204
|
|
201
|
-
For development of the **npm package @csedl/svelte-on-rails**
|
202
|
-
|
205
|
+
For development of the **npm package @csedl/svelte-on-rails** (optional) please download the source code of the
|
206
|
+
npm package and set
|
207
|
+
`local_npm_package_path` and set the path to the npm package on your local machine.
|
203
208
|
This will cause the installer, to install the npm package from a local path instead from the npm registry.
|
204
209
|
|
210
|
+
Then run the tests and start contributing.
|
211
|
+
|
205
212
|
Tests are based on the included templates, like the `hello world template` and on the installer.
|
206
213
|
|
214
|
+
Here I learned how to write tests! Testing installers is heavy, you will read about it in the
|
215
|
+
test_helpers. But I have done my best to give all the code a clear structure.
|
216
|
+
I hope you like it, and improvements are welcome.
|
217
|
+
|
207
218
|
**Installer tests** starting with completely destroy the rails app within the `generated_test_app_path`,
|
208
219
|
generating a new rails app and running the installer and test by `playwright` if the components are working.
|
209
220
|
|