Greenwood is your workbench for the web; focused on supporting modern web standards and development to help you create your next project. For information on getting started, reviewing our docs, or to learn more about the project and how it works, please visit our website.
Features:
- ⚡ No bundle development. Pages are built on the fly.
- 📝 HTML (and markdown) first authoring experience and ESM friendly.
- 🎁 Optimized production builds.
- 🚫 No JavaScript by default.
- 📖 Prerendering support for Web Components.
- ⚒️ Extensible via plugins.
- ⚙️ Supports SSG, MPA, SPA, and SSR project types. (or a hybrid!)
Greenwood is currently working towards a 1.0 release. If you're interested in learning more about the web and web development (at any skill level!), or interested in checking out our high level roadmap and how Greenwood got where it is today, you can read our State of GreenwoodJS blog post. We would love to have your help making Greenwood! ✌️
Our website has a complete Getting Started section that will walk you through creating a Greenwood project from scratch.
You can follow along with, or clone and go, the companion repo.
Greenwood can be installed with your favorite JavaScript package manager.
# npm
npm install @greenwood/cli --save-dev
# yarn
yarn add @greenwood/cli --devThen in your package.json, add the type field and scripts for the CLI, like so:
{
"type": "module",
"scripts": {
"build": "greenwood build",
"start": "greenwood develop",
"serve": "greenwood serve"
}
}greenwood build: Generates a production build of your projectgreenwood develop: Starts a local development server for your projectgreenwood serve: Generates a production build of your project and runs it on a NodeJS based web server
All of our documentation is on our website (which itself is built by Greenwood!). See our website documentation to learn more about:
- Configuration
- Pages
- Templates
- Component Model
- Styles and Assets
We would love your contribution to Greenwood! Please check out our issue tracker for "good first issue" labels or feel to reach out to us on Slack in the room "Greenwood" or on Twitter.
| Site | Repo | Project Details |
|---|---|---|
| The Greenhouse I/O | thegreenhouseio/www.thegreenhouse.io | Personal portfolio / blog website for @thescientist13 (Greenwood maintainer). |
| Contributary | ContributaryCommunity/www.contributary.community | A website (SPA) for browsing open source projects that are open to contributions. Built with Lit and hosted with AWS (S3 / CloudFront). |
| Analog Studios | AnalogStudiosRI/www.analogstudios.net | A local music studio SPA website, originally written in Angular 2, recently migrated to Lit. It is currently transitioning to a hybrid static + serverless website showing off the full potential of Greenwood and Web Components. Follow along for all the fun! 🤘 |
Built a site with Greenwood? Open a PR and add it here!
See the LICENSE file for license rights and limitations (MIT).