{"id":13467958,"url":"https://github.com/thoughtbot/bitters","last_synced_at":"2025-05-14T13:08:38.107Z","repository":{"id":6893993,"uuid":"8143643","full_name":"thoughtbot/bitters","owner":"thoughtbot","description":"Add a dash of pre-defined style to your Bourbon.","archived":false,"fork":false,"pushed_at":"2021-09-24T16:02:48.000Z","size":5917,"stargazers_count":1383,"open_issues_count":15,"forks_count":138,"subscribers_count":71,"default_branch":"main","last_synced_at":"2025-05-11T07:11:11.401Z","etag":null,"topics":["bitters","bourbon","bourbon-family","css","sass","scaffold","scaffold-styles","scss"],"latest_commit_sha":null,"homepage":"https://thoughtbot.com","language":"HTML","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}},"created_at":"2013-02-11T18:24:43.000Z","updated_at":"2025-05-03T02:19:55.000Z","dependencies_parsed_at":"2022-08-27T17:00:11.171Z","dependency_job_id":null,"html_url":"https://github.com/thoughtbot/bitters","commit_stats":null,"previous_names":[],"tags_count":26,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thoughtbot%2Fbitters","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thoughtbot%2Fbitters/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thoughtbot%2Fbitters/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thoughtbot%2Fbitters/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/thoughtbot","download_url":"https://codeload.github.com/thoughtbot/bitters/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254149974,"owners_count":22022852,"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":["bitters","bourbon","bourbon-family","css","sass","scaffold","scaffold-styles","scss"],"created_at":"2024-07-31T15:01:03.206Z","updated_at":"2025-05-14T13:08:32.454Z","avatar_url":"https://github.com/thoughtbot.png","language":"HTML","readme":"\u003cimg src=\"https://images.thoughtbot.com/bourbon/bitters-logo-v2.svg\" width=\"200\" alt=\"Bitters\"\u003e\n\n[![Reviewed by Hound](https://img.shields.io/badge/Reviewed_by-Hound-8E64B0.svg)](https://houndci.com)\n\n## Scaffold styles, variables and structure for web projects.\n\nBitters helps designers start projects faster by defining a basic set of CSS and Sass\nvariables, default element style and project structure. It’s been specifically\ndesigned for use within web applications. Bitters should live in your project’s\nroot Sass directory and we *encourage* you to modify and extend it to meet your\nproject's needs.\n\nBitters is made to work alongside a CSS reset or style-normalizer; not replace\none. We like to use [Normalize].\n\n[Normalize]: https://github.com/necolas/normalize.css/\n\n### Helpful Links\n\n- [Change log](CHANGELOG.md)\n- [Twitter](https://twitter.com/bourbonsass)\n- [Stack Overflow](https://stackoverflow.com/questions/tagged/bitters)\n\n## Table of Contents\n\n- [Requirements](#requirements)\n- [Installation](#installation)\n- [Using Bitters](#using-bitters)\n- [Command Line Interface](#command-line-interface)\n- [Contributing](#contributing)\n- [License](#license)\n- [About](#about)\n\n## Requirements\n\n- [Sass] 3.4+ or [LibSass] 3.3+\n- Ruby 1.9.3+ (required to install Bitters from the command line)\n\n[Sass]: https://github.com/sass/sass\n[LibSass]: https://github.com/sass/libsass\n\n## Installation\n\n1. Install the Bitters gem using the [RubyGems] package manager:\n\n    ```bash\n    gem install bitters\n    ```\n\n1. Install the Bitters library into the current directory by running the\n   following command at the command-line. If you’re using Ruby on Rails, run the\n   command in `app/assets/stylesheets`:\n\n    ```bash\n    bitters install\n    ```\n\n    A `base` directory will be generated which contains all of the Bitters\n    files.\n\n1. Import Bitters in your `application.css.scss` or main manifest\n   file. All additional stylesheets should be imported below Bitters.\n\n    ```scss\n    @import \"base/base\";\n    ```\n\n1. Once Bitters is set up, you can begin to import your styles\n   below them.\n\n    ```scss\n    @import \"base/base\";\n    @import \"my-project-styles\";\n    …\n    ```\n\n[RubyGems]: https://rubygems.org\n\n## Using Bitters\n\n### Sass structure \u0026 default style\n\nThe Bitters directory (`base/`) should contain styles for all the basic elements\nused throughout the project. Add code to the existing files or add new files.\nCustomize Bitters for your site as you see fit.\n\n### Variables\n\nThis houses all variables that are used, or will be used, in more than one file\nin your site.\n\n### Typography\n\nAll type is based on a `font-size` of `100%`, set on the `html` element.\n\n### Lists\n\nAll lists have stripped out styles. No bullets, no left padding.\n\n### Forms\n\nAdds basic styles all form elements. The variables at the top of the file all\ninherit from the variables file but make it really easy to be overridden.\n\n### Buttons\n\nBasic style for `button` and `input[type=\"submit\"]`. Base button styles can be\nchanged by modifying the styles applied to `button` as well as `[type='button']`,\n`[type='reset']`, and `[type='submit']` in the `base/_buttons.scss` file.\n\n## Command Line Interface\n\n```bash\nbitters [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| `bitters install` | Install Bitters into the current directory            |\n| `bitters reset`   | Reset Bitters                                         |\n| `bitters remove`  | Removes Bitters from the current directory            |\n| `bitters help`    | Show help                                             |\n| `bitters version` | Show the version number                               |\n\n## Contributing\n\nSee the [contributing] document. Thank you, [contributors]!\n\n[contributing]: CONTRIBUTING.md\n[contributors]: https://github.com/thoughtbot/bitters/graphs/contributors\n\n## License\n\nBitters is copyright © 2013-2019 [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## About\n\nBitters is maintained by the thoughtbot design team. It is funded by\n[thoughtbot, inc.][thoughtbot] and the names and logos for thoughtbot are\ntrademarks of thoughtbot, inc.\n\n[![thoughtbot][thoughtbot-logo]][thoughtbot]\n\nWe love open-source software! See [our other projects][community] or\n[hire us][hire] to design, develop, and grow your product.\n\n[thoughtbot]: https://thoughtbot.com?utm_source=github\n[thoughtbot-logo]: http://presskit.thoughtbot.com/images/thoughtbot-logo-for-readmes.svg\n[community]: https://thoughtbot.com/community?utm_source=github\n[hire]: https://thoughtbot.com/hire-us?utm_source=github\n","funding_links":[],"categories":["HTML","Gems"],"sub_categories":["CSS"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthoughtbot%2Fbitters","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthoughtbot%2Fbitters","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthoughtbot%2Fbitters/lists"}