Documentation

This is the documentation space for Greenwood that we hope will help you get the most out of using it. If this is your first time with Greenwood, we recommend checking out our Getting Started guide to get more familiar with setting up your first Greenwood project.

Installation

Greenwood can be installed with any of the common package managers available today.

# npm
$ npm install @greenwood/cli --save-dev

# yarn
$ yarn add @greeenwood/cli --dev

Though we recommend installing it locally to your project, you can also run Greenwood globally. For global usage we recommend using npx

$ npx @greenwood/cli <command>

CLI

With Greenwood installed, you can run its CLI to generate your site. The principal commands available are:

• greenwood develop: Starts a local development server for your project.
• greenwood build: Generates a production build of your project.
• greenwood serve: Generates a production build of the project and serves it locally on a simple web server.
• greenwood eject: Ejects CLI configurations (Just Rollup right now) to your working directory for more advanced customization. YMMV.

You can define npm scripts in package.json like so to automate your workflows:

{

  "scripts": {
    "build": "greenwood build",
    "start": "greenwood develop",
    "serve": "greenwood serve"
  }

}

Then from the command line you can use npm or Yarn to run them:

 # start up the dev server
$ npm start
$ yarn start

# generate a static build to deploy
$ npm run build
$ yarn build

# generate a static build and preview it locally
$ npm run serve
$ yarn serve

Sections

To continue learning more about Greenwood, please feel free to browse the other sections of our documentation.

• Component Model: Examples of using custom elements in Greenwood.
• Configuration: Available configuration options for the Greenwood CLI.
• Front Matter: Page level configurations through page markdown.
• Markdown: Using markdown and related authoring capabilities supported by Greenwood.
• Styles and Assets: How to style and theme your project with CSS.
• Templates: Controlling the layout of your pages.
• Tech Stack: What's under the hood.