bridgetownrb / lit-renderer-example

Demo repo showing off Bridgetown Lit Renderer

Bridgetown Lit Renderer Example

This demo site shows the capability of the Bridgetown Lit Renderer plugin. It allows you to create "islands" of Lit web component-based interactivity, complete with SSR + Hydration support.

To Run This Example Locally…

• Prerequisites
• Install
• Development
• Commands
• Deployment
• Contributing

Prerequisites

• GCC
• Make
• Ruby
  • >= 2.7
• Bridgetown Gem
  • gem install bridgetown -N
• Node
  • >= 12
• Yarn

Install

cd bridgetown-site-folder
bundle install && yarn install

Learn more: Bridgetown Getting Started Documentation.

Development

To start your site in development mode, run bin/bridgetown start and navigate to localhost:4000!

Commands

# running locally
bin/bridgetown start

# build & deploy to production
bin/bridgetown deploy

# load the site up within a Ruby console (IRB)
bin/bridgetown console

Learn more: Bridgetown CLI Documentation

Deployment

You can deploy Bridgetown sites on "Jamstack" hosts (Netlify, Vercel, Render, etc.) or virtually any tranditional web server by simply building and copying the output folder to your HTML root.

Read the Bridgetown Deployment Documentation for more information.

Contributing

If repo is on GitHub:

1. Fork it
2. Clone the fork using git clone to your local development machine.
3. Create your feature branch (git checkout -b my-new-feature)
4. Commit your changes (git commit -am 'Add some feature')
5. Push to the branch (git push origin my-new-feature)
6. Create a new Pull Request