🧚 Gracile

A thin, full-stack, web framework.

⚠️ Attention, please!

You might want to go to @gracile/gracile (with the @ scope).
This package is a stub. It will be re-used at a latter time.

Features:

• Portable HTML, CSS and JS, thanks to Lit (SSR).
• Highly responsive during dev. and build, thanks to Vite.
• Minimal dependency footprint for its runtime and your distributable.
• Embrace web standards like Custom Elements (aka Web Components) or the WhatWG Fetch API.
• A streamlined Developer eXperience for building, instead of fiddling around.

🏁 Get Started

Bootstrap a project with the create gracile@latest command:

npm create gracile@latest
pnpm create gracile@latest
bun create gracile@latest
yarn create gracile@latest

For more information, head over to the documentation website (gracile.js.org).

🌐 A platform-minded meta-framework

Gracile is powered by Vite and Lit SSR.

With it, you can achieve:

• File-based routing
• Server Side Rendering
• Static Site Generation
• Server integration (Request/Response) for Express
• Full-stack Custom Elements (Lit), with hydration
• Content websites
• Multi or Single Page Applications
• Progressive enhancements
• And more, via Add-ons (Markdown, Metadata, SVG…)

All that, with a few conventions, a standard-oriented approach and a very contained footprint 🤏.

Web Components, TypeScript, SASS, Lit, and other DX perks are all at your fingertips; while remaining optional.

Thanks to the Vite modular architecture, and Node.js versatility, developer experience is smoothed up across the board, while in development and when building for production.

👐 Contributing

See CONTRIBUTING.md.

• Documentation website (gracile.js.org)
• Documentation website repository
• Starter projects repository

“Perfection is achieved, not when there is nothing more to add, but when there is nothing left to take away.”

― Antoine de Saint-Exupéry, Airman's Odyssey