Description
Bridgetown is a Webpack-aware, Ruby-powered static site generator for the modern Jamstack era. Bridgetown takes your content and frontend assets, renders Markdown and Liquid templates, and exports a complete website ready to be served by Jamstack services like Netlify or traditional web servers like Nginx.
Bridgetown alternatives and similar gems
Based on the "Jekyll" category.
Alternatively, view Bridgetown alternatives based on common mentions on social networks and blogs.
InfluxDB - Power Real-Time Data Analytics at Scale
* Code Quality Rankings and insights are calculated and provided by Lumnify.
They vary from L1 to L5 with "L5" being the highest.
Do you think we are missing an alternative of Bridgetown or a related project?
README
Bridgetown
Bridgetown is a next-generation, progressive site generator & fullstack framework, powered by Ruby. Bridgetown takes your content, API data, and frontend assets; renders templates in Markdown, Liquid, ERB, and many other formats; and exports a complete website ready to be served by fast CDNs like Render or traditional web servers like Caddy or Nginx.
[
](LICENSE)
Special Thanks to Our GitHub Sponsors! 🙏 🎉
Say howdy 👋 to our growing list of past & present sponsors of Bridgetown on GitHub! You too can join this list and sponsor Bridgetown.
| @cabgfx | @andrewmcodes | @miatrinity | @marcoroth_ | @mtomov |
| Website | Website | Website |
| @johnchambers | @wout | @pascalwengerter | @DRBragg | @jasoncharnes |
| Website | Website | Website | Website |
| @leastbad | @asaaki | @scoutapm-sponsorships | @adrianvalenz | @bpo |
| Website | Website | Website |
| @williamkennedy | @eclectic-coding | @nbkkb7x | @jr180180 | @existentialmutt |
| Website | Website | Website | Website |
| @MikeRogers0 | @jespr | @jc00ke | @matoni109 | @rootnoob |
| Website | Website |
| @collindonnell | @AbuMareBear | @luctus | @pascallaliberte | @johlym |
| Website | Website | Website | Website |
| @subsevenx | @coreyaus | @joelhawksley | @onurozer | @oleingemann |
| Website | Website | Website | Website |
| @renuo | @maxveldink | @fuzzygroup | You Next? |
| Website | Website | Website |
Commercial Support
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.
Star History
Start Here
- Install the Bridgetown gem
- Familiarize yourself with the Command Line Usage and Site Configuration
- Explore the best options for Deploying Your Site when it's ready to go live
- Have questions? Check out our new Bridgetown Discussions on GitHub or chat on Discord
- Fork Bridgetown and contribute your own improvements!
Get Up to Speed
- Explore the Folder Structure of a Bridgetown website
- 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 or Webpack 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 bridgetown-core, if you want to run a single unit test, you can use the command:
$ script/test test/test_foo.rb
If you are only updating a Cucumber .feature file, you can use the command:
$ script/cucumber features/foo.feature
Both script/test and script/cucumber can be run without arguments to run its entire respective suite.
To switch one of your 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"
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](CODE_OF_CONDUCT.md) 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
Bridgetown is built by:
| @jaredcwhite | @jaredmoody | @andrewmcodes | @ParamagicDev | @MikeRogers0 |
| Portland, OR | Portland, OR | Wilmington, NC | Providence, RI | Ny-Ålesund, Svalbard |
| @wout | @codemargaret | @julianrubisch | @ianbayne | @ayushn21 |
| Brighton, UK | Portland, OR | Vienna, Austria | Tokyo, Japan | London, UK |
| @bkmgit | @pascalwengerter | @marketerly | @juanvqz | @katafrakt |
| Lisbon, Portugal | Tripoli, Libya | Oaxaca, México | Wrocław, PL |
| @erikyuzwa | @eclectic-coding | @collindonnell | @juhat | @debashis-biswal |
| Calgary, AB | North Carolina, US | Portland, OR | Budapest, Hungary |
| @nachoal | @deivid-rodriguez | @Eric-Guo | @jacobherrington | @fpsvogel |
| CDMX, México | Madrid, Spain | Shanghai, China | Fayetteville, AR | Lexington, KY |
| @vvveebs | You Next? |
| London, UK | Anywhere |
Interested in joining the Bridgetown Core Team? Send a DM to Jared in Discord and let's chat!
License
The gem is available as open source under the terms of the [MIT LICENSE](./LICENSE) file.
*Note that all licence references and agreements mentioned in the Bridgetown README section above
are relevant to that project's source code only.