Next Steps

About Greenwood

Thank you so much for taking the time to go through our Getting Started guide and we hope it has given you a good overview of how to work with Greenwood and what some of the possibilities are. To learn more about the project we encourage you to review our API docs to learn more about how you can use Greenwood or check out our repo to see what we're working on next, or if you need to reach out, feel free to open an issue!

Configuration

Although configuration is a topic all on its own, we do want to walk through setting up a configuration file for your project. As you may have noticed, the <title> of the site being made during the Getting Started section said Greenwood App. This is what Greenwood's configuration can be used for.

To change the title of the project (like in the companion repo), create a (NodeJS) module called greenwood.config.js at the root of your project and configure the export object with a title property.

module.exports = {
  title: 'My Personal Site'
};

That's it! You can learn more about configuring Greenwood here.

Companion Repo

You may have noticed that the Getting Started companion repo itself is a bit more of a full fledged example then captured in this guide, like with the use use of "Single File Components" (SFCs).

This is was intentional for a couple of reasons:

  • Education: There is always more than one way to solve a problem, and so we felt that the SFC approach was best for the guide so as to keep the number of steps needed as few and direct as possible.
  • Development: The other side of the coin is that for us having the CSS in an external file helps with development and maintenance. This is just a preference. Please choose what fits your workflow best.
  • Maintenance: We want to keep a loose coupling between the guide and the repository to avoid additional overhead maintaining the two and keeping them in sync. The goal of this guide is to focus on the overall experience of creating your first Greenwood project, not worrying about theming or project structure, since Greenwood generally supports just about any folder organization you could want and has no opinions on styles.

Resources

Since Greenwood aims to be a web "first" tool, all the great web development resources for the web already apply to Greenwood! Below are some resources that we think might be useful as part of a broader understanding of the topic of web development and that we have found invalualable for our own development and learning.

  • MDN - Mozilla Developer Network has some of the best technical and sample content available for learning about all the features and capabilities of the web.
  • Web Components - A brief introduction to the specs that make up Web Components.
  • CSS / Shadow DOM
  • CanIUse.com - Find out what browser support various JS and CSS features have.
  • LitElement / LitHtml - Helper libraries for working with Web Components that are available with Greenwood.
  • VSCode - A very popular IDE for JavaScript development with a lot of great plugins and integrations for web development related tools.
  • Git / GitHub: Although git != GitHub, version control plays a very important part in modern software development. GitHub in particular provides a lot of great integrations with tools like CircleCI and GitHub Actions for CI, and Netlify that can greatly automate a lot of the deployment process like building and deploying your apps. We plan to provide guides for these in the future, so stay tuned!