{"id":13419804,"url":"https://github.com/thoughtbot/bourbon","last_synced_at":"2025-04-08T07:24:53.453Z","repository":{"id":41203309,"uuid":"1653882","full_name":"thoughtbot/bourbon","owner":"thoughtbot","description":"A Lightweight Sass Tool Set","archived":false,"fork":false,"pushed_at":"2024-03-15T21:47:22.000Z","size":3149,"stargazers_count":9098,"open_issues_count":9,"forks_count":879,"subscribers_count":315,"default_branch":"main","last_synced_at":"2024-05-23T06:48:33.808Z","etag":null,"topics":["bourbon","bourbon-family","css","sass","sass-functions","sass-library","sass-mixins","scss"],"latest_commit_sha":null,"homepage":"https://www.bourbon.io/","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/thoughtbot.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2011-04-23T15:41:20.000Z","updated_at":"2024-06-18T10:52:45.757Z","dependencies_parsed_at":"2023-02-13T03:05:41.324Z","dependency_job_id":"70b6e789-f4c2-4cb1-9bd5-762bfdb8ca88","html_url":"https://github.com/thoughtbot/bourbon","commit_stats":{"total_commits":1107,"total_committers":156,"mean_commits":7.096153846153846,"dds":0.7868112014453478,"last_synced_commit":"c3551e46f41738681216a7f957bc88bc79155b16"},"previous_names":[],"tags_count":101,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thoughtbot%2Fbourbon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thoughtbot%2Fbourbon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thoughtbot%2Fbourbon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thoughtbot%2Fbourbon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/thoughtbot","download_url":"https://codeload.github.com/thoughtbot/bourbon/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247271515,"owners_count":20911587,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bourbon","bourbon-family","css","sass","sass-functions","sass-library","sass-mixins","scss"],"created_at":"2024-07-30T22:01:21.127Z","updated_at":"2025-04-08T07:24:53.392Z","avatar_url":"https://github.com/thoughtbot.png","language":"Ruby","readme":"[\u003cimg src=\"https://images.thoughtbot.com/bourbon/bourbon-logo.svg\" width=\"200\" alt=\"Bourbon logo\"\u003e][Bourbon]\n\n[![Reviewed by Hound](https://img.shields.io/badge/Reviewed_by-Hound-8E64B0.svg)](https://houndci.com)\n\n## Deprecated as of September 13, 2024\n\nThis project is no longer maintained. We encourage people to leverage the modern native CSS features in lieu of this library. You can refer to [our blog post](https://thoughtbot.com/blog/you-might-not-need-bourbon) on how to go about replacing or rethinking each helper.\n\n## A Lightweight Sass Tool Set\n\n[Bourbon] is a library of [Sass] mixins and functions that are designed to make\nyou a more efficient style sheet author.\n\nIt is…\n\n- Dependency-free: Bourbon is pure Sass.\n- Human-readable: We aim for clarity over brevity.\n- Lightweight: Zero output post-install and has no visual opinion.\n\n  [Bourbon]: https://www.bourbon.io/\n  [Sass]: http://sass-lang.com\n\n### Helpful Links\n\n- [Documentation](https://www.bourbon.io/docs/latest/)\n- [Change log](CHANGELOG.md)\n- [Twitter](https://twitter.com/bourbonsass)\n- [Stack Overflow](https://stackoverflow.com/questions/tagged/bourbon)\n\n## Table of Contents\n\n- [Requirements](#requirements)\n- [Installation](#installation)\n- [Command Line Interface](#command-line-interface)\n- [Browser Support](#browser-support)\n- [Contributing](#contributing)\n- [License](#license)\n- [About](#about)\n\n## Requirements\n\n- [Sass] 3.4+ or [LibSass] 3.3+\n\n  [Sass]: https://github.com/sass/sass\n  [LibSass]: https://github.com/sass/libsass\n\n## Installation\n\n1. Install the Bourbon gem using the [RubyGems] package manager:\n\n    ```bash\n    gem install bourbon\n    ```\n\n1. Install the Bourbon library into the current directory:\n\n    ```bash\n    bourbon install\n    ```\n\n    **Pro Tip:** You can target installation into a specific directory using the\n    `path` flag:\n\n    ```bash\n    bourbon install --path my/custom/path/\n    ```\n\n1. Import Bourbon at the beginning of your stylesheet:\n\n    ```scss\n    @import \"bourbon/bourbon\";\n    ```\n\n    It’s not recommended that you modify Bourbon’s files directly as it will\n    make updating to future versions difficult, by overwriting your custom\n    changes or causing merge conflicts.\n\n  [RubyGems]: https://rubygems.org\n\n### Installation for Ruby on Rails 4.2+\n\n1. Add Bourbon to your Gemfile:\n\n    ```ruby\n    gem \"bourbon\"\n    ```\n\n1. Then run:\n\n    ```bash\n    bundle install\n    ```\n\n1. Restart your server and rename `application.css` to `application.scss`:\n\n    ```bash\n    mv app/assets/stylesheets/application.css app/assets/stylesheets/application.scss\n    ```\n\n1. Delete _all_ Sprockets directives in `application.scss` (`require`,\n   `require_tree` and `require_self`) and use Sass’s native `@import` instead\n   ([why?][sass-import]).\n\n1. Import Bourbon at the beginning of `application.scss`. Any project styles\n   that utilize Bourbon’s features must be imported after Bourbon.\n\n    ```scss\n    @import \"bourbon\";\n    @import \"home\";\n    @import \"users\";\n    ```\n\n  [sass-import]: https://content.pivotal.io/blog/structure-your-sass-files-with-import\n\n### Installing with npm and using a Node-based asset pipeline\n\n1. Add Bourbon as a dependency:\n\n    ```bash\n    npm install --save bourbon\n    ```\n\n1. If you’re using [eyeglass], skip to Step 3. Otherwise, you’ll need to add\n   Bourbon to your node-sass `includePaths` option.\n   `require(\"bourbon\").includePaths` is an array of directories that you should\n   pass to node-sass. How you do this depends on how node-sass is integrated\n   into your project.\n\n1. Import Bourbon into your Sass files:\n\n    ```scss\n    @import \"bourbon\";\n    ```\n\n  [eyeglass]: https://github.com/sass-eyeglass/eyeglass\n\n### Installing older versions of Bourbon\n\n1. Uninstall any Bourbon gem versions you already have:\n\n    ```bash\n    gem uninstall bourbon\n    ```\n\n1. Reinstall the Bourbon gem, using the `-v` flag to specify the version\n   you need:\n\n    ```bash\n    gem install bourbon -v 4.2.7\n    ```\n\n1. Follow the [instructions above](#installation) to install Bourbon into\n   your project.\n\n## Command Line Interface\n\n```bash\nbourbon [options]\n```\n\n### Options\n\n| Option            | Description               |\n| :---------------- | :------------------------ |\n| `-h`, `--help`    | Show help                 |\n| `-v`, `--version` | Show the version number   |\n| `--path`          | Specify a custom path     |\n| `--force`         | Force install (overwrite) |\n\n### Commands\n\n| Command           | Description                                           |\n| :---------------- | :---------------------------------------------------- |\n| `bourbon install` | Install Bourbon into the current directory            |\n| `bourbon update`  | Overwrite and update Bourbon in the current directory |\n| `bourbon help`    | Show help                                             |\n\n## Browser Support\n\nBourbon supports Internet Explorer 11+ and the latest versions of Chrome,\nFirefox, Safari, and Edge.\n\n## Contributing\n\nSee the [contributing] document. Thank you, [contributors]!\n\n  [contributing]: CONTRIBUTING.md\n  [contributors]: https://github.com/thoughtbot/bourbon/graphs/contributors\n\n## License\n\nBourbon is copyright © 2011 [thoughtbot, inc.][thoughtbot] It is free\nsoftware, and may be redistributed under the terms specified in the [license].\n\n  [license]: LICENSE.md\n\n\u003c!-- START /templates/footer.md --\u003e\n## About thoughtbot\n\n![thoughtbot](https://thoughtbot.com/thoughtbot-logo-for-readmes.svg)\n\nThis repo is maintained and funded by thoughtbot, inc.\nThe names and logos for thoughtbot are trademarks of thoughtbot, inc.\n\nWe love open source software!\nSee [our other projects][community].\nWe are [available for hire][hire].\n\n[community]: https://thoughtbot.com/community?utm_source=github\n[hire]: https://thoughtbot.com/hire-us?utm_source=github\n\n\n\u003c!-- END /templates/footer.md --\u003e\n\n[thoughtbot]: https://thoughtbot.com?utm_source=github\n","funding_links":[],"categories":["Ruby","CSS","CSS and Styling","Web Development","Assets","Frontend"],"sub_categories":["CSS with Ruby","Preprocessors"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthoughtbot%2Fbourbon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthoughtbot%2Fbourbon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthoughtbot%2Fbourbon/lists"}