{"id":13550033,"url":"https://github.com/thoughtbot/neat","last_synced_at":"2025-10-05T18:31:29.208Z","repository":{"id":4160859,"uuid":"5275559","full_name":"thoughtbot/neat","owner":"thoughtbot","description":"A fluid and flexible grid Sass framework","archived":true,"fork":false,"pushed_at":"2019-10-21T13:48:02.000Z","size":1870,"stargazers_count":4418,"open_issues_count":0,"forks_count":424,"subscribers_count":177,"default_branch":"master","last_synced_at":"2024-10-29T22:57:07.321Z","etag":null,"topics":["bourbon","bourbon-family","css","grid","grid-framework","sass","scss"],"latest_commit_sha":null,"homepage":"https://neat.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}},"created_at":"2012-08-02T17:28:38.000Z","updated_at":"2024-10-29T14:30:35.000Z","dependencies_parsed_at":"2022-08-20T13:10:56.326Z","dependency_job_id":null,"html_url":"https://github.com/thoughtbot/neat","commit_stats":null,"previous_names":[],"tags_count":35,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thoughtbot%2Fneat","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thoughtbot%2Fneat/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thoughtbot%2Fneat/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thoughtbot%2Fneat/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/thoughtbot","download_url":"https://codeload.github.com/thoughtbot/neat/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":235043923,"owners_count":18927010,"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","grid","grid-framework","sass","scss"],"created_at":"2024-08-01T12:01:28.281Z","updated_at":"2025-10-05T18:31:23.907Z","avatar_url":"https://github.com/thoughtbot.png","language":"Ruby","readme":"[\u003cimg src=\"http://images.thoughtbot.com/bourbon/neat-logo-v2.svg\" width=\"200\" alt=\"Neat logo\"\u003e][Neat]\n\n[![Reviewed by Hound](https://img.shields.io/badge/Reviewed_by-Hound-8E64B0.svg)](https://houndci.com)\n\n## A lightweight and flexible Sass grid\n\n**Note:** This project is no longer maintained. We favor and encourage people to use\nnative CSS features like Grid and Flexbox. Float-based grid frameworks like Neat\nare no longer necessary.\n\n[Neat] is a fluid grid framework with the aim of being easy enough to\nuse out of the box and flexible enough to customize down the road.\n\n  [Neat]: https://neat.bourbon.io/\n\n### Helpful Links\n\n- [Demos](https://neat.bourbon.io/examples/)\n- [Documentation](https://neat.bourbon.io/docs/latest/)\n- [Change log](CHANGELOG.md)\n- [Twitter](https://twitter.com/bourbonsass)\n- [Stack Overflow](https://stackoverflow.com/questions/tagged/neat)\n- [Neat 2.0 Building the future of floated Sass grids](https://robots.thoughtbot.com/building-the-future-of-floated-css-grids) by [@whmii](http://social.mcmahan.me)\n- [Getting started with Neat 2.0, a lightweight and flexible Sass grid](https://robots.thoughtbot.com/the-release-of-neat-2-0-a-lightweight-and-flexible-sass-grid) by [@whmii](http://social.mcmahan.me)\n\n## Table of Contents\n\n- [Requirements](#requirements)\n- [Installation](#installation)\n- [Command Line Interface](#command-line-interface)\n- [The Bourbon Family](#the-bourbon-family)\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 Neat gem using the [RubyGems] package manager:\n\n   ```bash\n   gem install neat\n   ```\n\n1. Install or update Neat’s dependencies:\n\n   ```bash\n   gem install sass # or gem update sass\n   ```\n\n   **Pro Tip:** You can target installation into a specific directory using the\n   `path` flag:\n\n   ```bash\n   neat install --path my/custom/path/\n   ```\n\n1. Install the Neat library into the current directory:\n\n   ```bash\n   neat install\n   ```\n\n1. Import Neat in your stylesheet:\n\n   ```scss\n   @import \"neat/neat\";\n   ```\n\n   It’s not recommended to add or modify the Neat files so that you can update\n   them easily.\n\n[RubyGems]: https://rubygems.org\n\n### Installation for Ruby on Rails 4.2+\n\n1. Add Neat to your Gemfile:\n\n   ```ruby\n   gem \"neat\"\n   ```\n\n1. Then run:\n\n   ```bash\n   bundle install\n   ```\n\n   If you see the error `Bundler could not find compatible versions for gem\n   \"sass\"`, run:\n\n   ```bash\n   bundle update sass\n   ```\n\n1. Import Neat in your `application.scss`:\n\n   ```scss\n   @import \"neat\";\n   ```\n\n   It should be noted that `@import` rules are not compatible with Sprockets\n   directives. You need to use one or the other.\n\n### Installing with npm and using a Node-based asset pipeline\n\n1. Add Neat as a dependency:\n\n   ```bash\n   npm install --save bourbon-neat\n   ```\n\n1. If you’re using [eyeglass], skip to Step 3. Otherwise, you’ll need to add\n   Neat to your node-sass `includePaths` option.\n   `require(\"bourbon-neat\").includePaths` is an array of directories that you\n   should pass to node-sass. How you do this depends on how node-sass is\n   integrated into your project.\n\n1. Import Neat into your Sass files:\n\n   ```scss\n   @import \"neat\";\n   ```\n\n[eyeglass]: http://eyeglass.rocks\n\n### Installing older versions of Neat\n\n1. Uninstall any Neat gem versions you already have:\n\n   ```bash\n   gem uninstall neat\n   ```\n\n1. Reinstall the Neat gem, using the `-v` flag to specify the version you need:\n\n   ```bash\n   gem install neat -v 1.8.1\n   ```\n\n1. Follow the [instructions above](#installation) to install Neat into your\n   project.\n\n## Command Line Interface\n\n```bash\nneat [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| `neat install` | Install Neat into the current directory            |\n| `neat update`  | Overwrite and update Neat in the current directory |\n| `neat remove`  | Removes Neat from the current directory            |\n| `neat help`    | Show help                                          |\n| `neat version` | Show the version number                            |\n\n## The Bourbon family\n\n- [Bourbon]: A lightweight Sass tool set\n- [Bitters]: Scaffold styles, variables and structure for Bourbon projects\n\n  [Bourbon]: https://github.com/thoughtbot/bourbon\n  [Bitters]: https://github.com/thoughtbot/bitters\n\n## Contributing\n\nSee the [contributing] document. Thank you, [contributors]!\n\n  [contributing]: CONTRIBUTING.md\n  [contributors]: https://github.com/thoughtbot/neat/graphs/contributors\n\n## License\n\nNeat is copyright © 2012 [thoughtbot, inc.][thoughtbot] It is free software, and\nmay be redistributed under the terms specified in the [license].\n\n  [license]: LICENSE.md\n\n## About\n\nNeat 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 logo](https://presskit.thoughtbot.com/images/thoughtbot-logo-for-readmes.svg)][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  [community]: https://thoughtbot.com/community?utm_source=github\n  [hire]: https://thoughtbot.com/hire-us?utm_source=github\n","funding_links":[],"categories":["Ruby","css"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthoughtbot%2Fneat","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthoughtbot%2Fneat","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthoughtbot%2Fneat/lists"}