Iles

The joyful site generator

ElMassimo/iles iles.pages.dev iles

README

îles — french word for "islands"

Islands of interactivity with Vue, Preact, Svelte, Solid, and more

[îles]: https://github.com/ElMassimo/iles

[docs]: https://iles-docs.netlify.app

[twitter]: https://twitter.com/ilesjs

[follow me]: https://twitter.com/MaximoMussini

[guide]: https://iles-docs.netlify.app/guide/introduction

[configuration reference]: https://iles-docs.netlify.app/config

[blog]: https://the-vue-point-with-iles.netlify.app/

[partial hydration]: https://iles-docs.netlify.app/guide/hydration

[Batteries Included]: https://iles-docs.netlify.app/guide/development#components

[Multi-Framework]: https://iles-docs.netlify.app/guide/frameworks

[markdown]: https://iles-docs.netlify.app/guide/markdown

[routing]: https://iles-docs.netlify.app/guide/routing

[devtools]: https://user-images.githubusercontent.com/1158253/133314267-f0ba784c-ff64-4ee8-b2bf-97ecffc2facd.jpg

[hydration timeline]: https://user-images.githubusercontent.com/1158253/133314279-1edc22d1-3ffb-414e-b994-212cb316593b.jpg

[stackblitz]: https://stackblitz.com/fork/iles?file=src%2Fcomponents%2FWelcome.vue

Features ✨

- 🏝 [Partial Hydration] - zero JS by default, hydrates the interactive bits

- 🔌 [Batteries Included] - layouts, components, site-wide data

- 🧱 [Multi-Framework] - vue, preact, svelte, solid

- 📖 [Markdown] - use components in markdown and viceversa

- 🛣 [Routing] - automatically configured from files

- 🛠 [Devtools][devtools] - debug panel and [hydration timeline]

- ⚡️ [Fast][Vite] - instant reloading powered by [Vite]

Demos 🚀

__[Documentation Website][docs]__

__[Official Vue.js Blog][blog]__

Try it Online ⚡️

[

][stackblitz]

Installation 💿

``` sh
pnpm create iles@next # or npm or yarn
```

Documentation 📖

Visit the [documentation website][docs] to check out the [guides][guide] and searchable [configuration reference].

News 🗞

[Follow me] or the [official îles account][twitter] on [Twitter].

Acknowledgements 🙇‍♂️

- [Vite] and [Vue]: for enabling an amazing development experience

- Astro: for sharing a novel way to define islands

- [MDX]: provides amazing flexibility when processing Markdown

- [vue-router], [@vueuse/head], and [vite-plugin-pages]: the backbone of this library

- [unplugin-vue-components]: allows you to avoid the boilerplate

- [VitePress] and [vite-ssg]: for their different ideas on SSR

[Vite]: https://vitejs.dev/

[Vue]: https://v3.vuejs.org/

[MDX]: https://github.com/mdx-js/mdx

[Astro]: https://docs.astro.build/core-concepts/component-hydration

[vite-plugin-pages]: https://github.com/hannoeru/vite-plugin-pages

[unplugin-vue-components]: https://github.com/antfu/unplugin-vue-components

[VitePress]: https://vitepress.vuejs.org/

[vite-ssg]: https://github.com/antfu/vite-ssg

[vue-router]: https://next.router.vuejs.org/

[@vueuse/head]: https://github.com/vueuse/head