Skip to content

Commit 400f1f8

Browse files
Add instructions how to migrate from sass-rails
1 parent 35cd405 commit 400f1f8

File tree

1 file changed

+24
-1
lines changed

1 file changed

+24
-1
lines changed

README.md

Lines changed: 24 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,6 @@ When you're developing your application, you want to run Dart Sass in watch mode
1616
1. Run `./bin/bundle add dartsass-rails`
1717
2. Run `./bin/rails dartsass:install`
1818

19-
2019
## Building in production
2120

2221
The `dartsass:build` is automatically attached to `assets:precompile`, so before the asset pipeline digests the files, the Dart Sass output will be generated.
@@ -39,6 +38,30 @@ The hash key is the relative path to a Sass file in `app/assets/stylesheets/` an
3938
## Importing assets from gems
4039
`dartsass:build` includes application [assets paths](https://guides.rubyonrails.org/asset_pipeline.html#search-paths) as Sass [load paths](https://sass-lang.com/documentation/at-rules/use#load-paths). Assuming the gem has made assets visible to the Rails application, no additional configuration is required to use them.
4140

41+
## Migrating from sass-rails
42+
43+
If you're migrating from [sass-rails](https://github.com/rails/sass-rails)
44+
(applies to [sassc-rails](https://github.com/sass/sassc-rails) as well)
45+
and want to switch to dartsass-rails, follow these instructions below:
46+
47+
1. Remove the sass-rails gem from the Gemfile by running
48+
49+
```
50+
./bin/bundle remove sass-rails
51+
```
52+
53+
1. Install dartsass-rails by following the
54+
[Installation](#installation) instructions above
55+
56+
1. Remove any references to Sass files from the Sprockets manifest file:
57+
`app/assets/config/manifest.js`
58+
59+
1. In your continues integration pipeline, before running any tests that
60+
interacts with the browser, make sure to build the Sass files by running:
61+
62+
```
63+
bundle exec rails dartsass:build
64+
```
4265
4366
## Version
4467

0 commit comments

Comments
 (0)