Bridgetown Website README

Welcome to your new Bridgetown website! You can update this README file to provide additional context and setup information for yourself or other contributors.

Table of Contents

• Bridgetown Website README
  • Table of Contents
  • Prerequisites
  • Install
  • Development
    • Commands
  • Deployment
  • Contributing

Prerequisites

• GCC
• Make
• Ruby
  • >= 3.2
• Bridgetown Gem
  • gem install bridgetown -N
• Node
  • >= 20

Install

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

Learn more: Bridgetown Getting Started Documentation.

Development

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

On macOS, bin/dev sets OBJC_DISABLE_INITIALIZE_FORK_SAFETY=YES before launching Ruby to avoid Objective-C fork-safety crashes seen with bridgetown start.

Use a theme or add some plugins to get started quickly.

Commands

# running locally
bin/dev

# alternate direct command (may require OBJC_DISABLE_INITIALIZE_FORK_SAFETY=YES on macOS)
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 hosts like statichost.eu and Render as well as traditional web servers 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