You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Bridgetown is a next-generation, progressive site generator & fullstack framework, powered by Ruby. Bridgetown takes your local content and external data loaded from APIs; renders templates in Markdown, ERB, and many other formats; automatically compiles frontend assets via esbuild; and exports a complete website ready to be served by fast CDNs like Render or traditional web servers. Bridgetown also integrates closely with Roda for fullstack, dynamic web application functionality—but only when and where you need it.
Bridgetown development is spearheaded by Portland-based web studio Whitefusion. Contact us if you need commercial support for your Bridgetown content strategy, site design, or deployment. Also providing commercial support: Radioactive Toy based in the UK.
Start adding content to your site in the form of Resources
Learn how Front Matter works for adding metadata to resources
Add extra information to your site with Data Files
Customize the Permalinks your resources are generated with
Use Template Engines like Liquid, ERB, and Serbea to author sophisticated template designs
Extend with Custom Plugins to generate and manipulate content specific to your site
Discover how to add Frontend Assets using esbuild for a modern Javascript & CSS build pipeline
Testing Locally
If you'd like to hack away on Bridgetown directly, you'll need to clone this repo and ensure the test suite passes. Note that this is a "monorepo", meaning that multiple Rubygem codebases are stored within a single repo.
$ git clone [email protected]:bridgetownrb/bridgetown.git
$ cd bridgetown
$ bundle # install development gems
$ bundle exec rake # run the full test suite
After making changes in one of the gems, say bridgetown-core, if you want to run a single unit test, you can use the command:
$ script/test test/test_foo.rb
Or run script/test to run the full test suite. You can also run script/cibuild to include Rubocop linting, etc., and at the root level of the repo, run bundle exec rake test_all to test the entire monorepo.
To switch one of your own website repos to using the local gem, add the local gem path to
the site's Gemfile as follows:
gem"bridgetown-core",path: "/path/to/bridgetown/bridgetown-core"# additional gems as needed
Need help?
If you don't find the answer to your problem in our docs, ask the community for help.
Code of Conduct
In order to have a more open and welcoming community, Bridgetown adheres to a
code of conduct adapted from the Contributor Covenant.
Please adhere to this code of conduct in any interactions you have in the
Bridgetown community. It is strictly enforced on all official Bridgetown
repositories, websites, and resources. If you encounter someone violating
these terms, please let one of our core team members know and we will address it as soon as possible.
Contributors
Note
Interested in joining the Bridgetown Core Team? Send a DM to Jared in Discord and let's chat!
