ElMassimo / iles

🏝 The joyful site generator
https://iles.pages.dev
MIT License
1.08k stars 31 forks source link

question: purpose of this library #5

Closed mesqueeb closed 2 years ago

mesqueeb commented 2 years ago

First of all: I love this library's docs! Very nice : ) beautiful and lovely design.

I would love to know what the main difference is with Vitepress. It's kinda similar from what I can gather.

ElMassimo commented 2 years ago

Hi @mesqueeb! Thanks for the kind words!

I plan to add in-depth comparisons to the docs soon, I'll keep this issue open in the meantime as a reminder.

They are indeed very similar, I love Vitepress! In fact, if you are creating a documentation website, it might be a better fit than îles. I'm using îles for its docs mostly for dogfooding purposes.

I started working on îles because I wanted Astro + Vitepress. This was before Astro announced they would move away from Snowpack, and before Vitepress had MPA mode (zero interactivity build).

The main difference is that îles provides great support partial hydration, so you can ship JS only for the interactive parts of the page by simply adding client: directives. In Vitepress partial hydration is still a manual process.

In the future I might explore bringing partial hydration to Vue SSR itself, which would allow using it in all frameworks.


TL'DR: You can use îles for most apps that you would build on Vitepress, but have a lot more control, specially when it comes to layouts and importing other pages.

It's easier to build blogs in îles than in Vitepress, and if you need a SPA you would go with Vitepress.