Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/elmassimo/jekyll-vite

⚡️🩸 Use Vite.js in Jekyll as your assets pipeline
https://github.com/elmassimo/jekyll-vite

assets jekyll ruby ruby-gem static-site-generator vitejs

Last synced: 1 day ago
JSON representation

⚡️🩸 Use Vite.js in Jekyll as your assets pipeline

Awesome Lists containing this project

README

        






Jekyll ➕ Vite.js




Build Status


Maintainability


Test Coverage


Gem Version


License

[vite ruby]: https://github.com/ElMassimo/vite_ruby
[website]: https://jekyll-vite.netlify.app/
[jekyll]: https://jekyllrb.com/
[configuration reference]: https://vite-ruby.netlify.app/config/
[features]: https://vite-ruby.netlify.app/guide/introduction.html
[guides]: https://vite-ruby.netlify.app/guide/
[config]: https://vite-ruby.netlify.app/config/
[vite.js]: http://vitejs.dev/
[Issues]: https://github.com/ElMassimo/jekyll-vite/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc
[Discussions]: https://github.com/ElMassimo/jekyll-vite/discussions
[no bundling]: https://vitejs.dev/guide/why.html#the-problems
[bundling]: https://vitejs.dev/guide/why.html#why-bundle-for-production
[rollup.js]: https://rollupjs.org
[esbuild]: https://esbuild.github.io/
[example]: https://github.com/ElMassimo/jekyll-vite/tree/main/docs
[installation]: https://jekyll-vite.netlify.app/posts/installation/

Use [Vite.js] in [Jekyll] and enjoy a modern assets pipeline! ⚡️

_This integration is powered by [__Vite Ruby__][Vite Ruby]_.

## Features ⚡️

- ⚡️ Blazing fast hot reload
- 📦 Zero-config builds
- 🎨 Use your favorite tools (TypeScript, Tailwind CSS, etc.)

## Why Vite? 🤔

[Jekyll] does not have an extensible asset pipeline, which limits the amount of
integrations that exist for different languages and preprocessors. By default,
assets are not fingerprinted which is problematic for caching.

[Vite.js] has an extensible architecture and is built on top of [rollup.js], and as
a result there is an active ecosystem of plugins and tooling available. In addition,
its [no bundling] design provides a very fluid authoring experience—changes to
your assets are reflected instantly in your browser.

## Documentation 📖

The [documentation website][website] is built using `jekyll-vite`.

You can [check the source to see an example setup][example], or visit it to
[learn how to use `jekyll-vite`][website].

## Installation 💿

Add this line to your site's Gemfile:

```ruby
gem 'jekyll-vite'
```

Then, run:

```bash
bundle install
bundle exec vite install
```

Additional [installation instructions][installation] are available in the [documentation website][installation].

## Contact ✉️

Please use [Issues] to report bugs you find, and [Discussions] to make feature requests or get help.

Don't hesitate to _⭐️ star the project_ if you find it useful!

Using it in your site? Always love to hear about it! 😃

## Acknowledgements

- [Jekyll] — Even after all this time, it's still a great static site generator.
- [Vite.js] — Frontend tooling with a focus on the developer experience.

## License

The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).