đź“ť Edit page
âž• Add page
Bridgetown
Related projects
See Bridgetown resources.
Set up a new Bridgetown project
Use the Bridgetown CLI to set up a new project, including sample content and dependencies.
The advantage of this is that you can skip installing Bridgetown in your global gems, but you still get use Bridgetown to create a basic project for you so you can get running quickly.
Requirements
- Install Node and Yarn - see instructions.
- Install Ruby and Bundler - see instructions.
Steps
Here’s is what we’ll do.
- Set up an initial project with a Gemfile only
- Configure Bundler to run the project scope without getting errors that you need root access.
- Use that to install a Bridgetown at the project level.
- Create a new Bridgetown project in the same directory (overwriting the temporary Gemfile).
Run these in your shell.
$ mkdir my-site
$ cd my-site
$ bundle config set --local path vendor/bundle
$ bundle init
$ bundle add bridgetown
$ bundle exec bridgetown new . --force
Start the dev server.
$ yarn start
To get an idea of the site you’ll generate, see my bridgetown-quickstart repo.
Add plugin
Add a plugin with the bridgetown_plugins
group.
$ bundle add some-new-plugin -g bridgetown_plugins