{"id":16635789,"url":"https://github.com/ythecombinator/flat-palettes","last_synced_at":"2025-12-26T02:13:46.837Z","repository":{"id":42016476,"uuid":"52738667","full_name":"ythecombinator/flat-palettes","owner":"ythecombinator","description":"🎨Need color inspiration? No problem! Have some fantastic random color palettes.","archived":false,"fork":false,"pushed_at":"2022-07-04T23:51:40.000Z","size":43,"stargazers_count":45,"open_issues_count":2,"forks_count":3,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-03-09T00:05:37.168Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/flat-palettes","language":"LiveScript","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/ythecombinator.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-02-28T19:19:56.000Z","updated_at":"2024-11-25T17:32:23.000Z","dependencies_parsed_at":"2022-08-19T22:30:20.706Z","dependency_job_id":null,"html_url":"https://github.com/ythecombinator/flat-palettes","commit_stats":null,"previous_names":["mabrasil/flat-palettes"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ythecombinator%2Fflat-palettes","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ythecombinator%2Fflat-palettes/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ythecombinator%2Fflat-palettes/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ythecombinator%2Fflat-palettes/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ythecombinator","download_url":"https://codeload.github.com/ythecombinator/flat-palettes/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243135826,"owners_count":20241984,"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":[],"created_at":"2024-10-12T06:04:47.002Z","updated_at":"2025-12-26T02:13:41.804Z","avatar_url":"https://github.com/ythecombinator.png","language":"LiveScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003ca href=\"\"\u003e\n    \u003cimg alt=\"Logo\" src=\"logo.png\" width=\"500px\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  Need color inspiration? No problem! Have some fantastic random color palettes.\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n\n  \u003ca href=\"https://codeship.com/projects/144431\"\u003e\u003cimg alt=\"Build Status\" src=\"https://codeship.com/projects/884fd3f0-dd82-0133-4ac9-0a409e517203/status?branch=master\"\u003e\u003c/a\u003e\n\n  \u003ca href=\"https://travis-ci.org/mabrasil/flat-palettes\"\u003e\u003cimg alt=\"Build Status\" src=\"https://travis-ci.org/mabrasil/flat-palettes.svg?branch=master\"\u003e\u003c/a\u003e\n\n  \u003ca href=\"https://codeclimate.com/github/mabrasil/flat-palettes\"\u003e\u003cimg alt=\"Code Climate\" src=\"https://codeclimate.com/github/mabrasil/flat-palettes/badges/gpa.svg\"/\u003e\u003c/a\u003e\n\n  \u003ca href=\"https://david-dm.org/mabrasil/flat-palettes\" title=\"Dependency status\"\u003e\u003cimg src=\"https://david-dm.org/mabrasil/flat-palettes.svg\"/\u003e\u003c/a\u003e\n\n  \u003ca href=\"https://david-dm.org/mabrasil/flat-palettes#info=devDependencies\" title=\"devDependency status\"\u003e\u003cimg src=\"https://david-dm.org/mabrasil/flat-palettes/dev-status.svg\"/\u003e\u003c/a\u003e\n\n\u003c/p\u003e\n\n## Table of Contents\n\n- [Installation](#installation)\n- [Usage](#usage)\n  - [Node](#node)\n  - [CLI](#cli)\n- [Development](#development)\n- [Contributing](#contributing)\n- [Motivation](#motivation)\n- [License](#license)\n- [Credits](#credits)\n\n## Installation\n\n### Node\n\n```sh\n$ npm install --save flat-palettes\n```\n\n### CLI\n\n```sh\n$ npm install -g flat-palettes\n```\n\n## Usage\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"\"\u003e\n    \u003cimg alt=\"Screenshot\" src=\"http://i.imgur.com/M3jdU2P.png\" width=\"700px\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n### Node\n\n```js\nconst colors = require('flat-palettes');\n\ncolors(3);\n//=\u003e ['#f7a61b', '#7cbf42', '#eb4a24']\n\ncolors(5);\n//=\u003e ['#1f518b', '#1488c8', '#f7e041', '#e2413e', '#e91222']\n```\n\n#### API\n\n##### `colors(numberOfColors)`\n\n###### `numberOfColors`\n\n*Type*: `Number`\n\n*Range*: `1` - `5`\n\n*Description*: How many colors do you want in your flat palette?\n\n*Example*: `3`\n\n### CLI\n\nAll you got to do is:\n\n```sh\n$ flat-palettes \u003cnumberOfColors\u003e\n```\n\nWhere `\u003cnumberOfColors\u003e` is the same described [here](#numberofcolors).\n\n![GIFs \u003c3](http://i.imgur.com/OJUc35K.gif)\n\n\u003e The commands above (in the *GIF*) gave you the following palettes:\n\n\u003e \u003cimg alt=\"3-colors Palette\" src=\"http://i.imgur.com/4EAo810.png\" width=\"550px\"\u003e\n\n\u003e And:\n\n\u003e \u003cimg alt=\"5-colors Palette\" src=\"http://i.imgur.com/wNu9BWW.png\" width=\"550px\"\u003e\n\n\u003e *Pretty eye candy, huh?*\n\n#### Options\n\n| **Option**  |               **Description**                |\n|-------------|----------------------------------------------|\n| `--help`    | Shows project description and how to use it. |\n| `--version` | Displays the current version.                |\n\n## Development\n\nAll the tasks needed for development automation are defined in the\n[`package.json`](package.json) *scripts* property and can be run via:\n\n`npm run \u003ccommand\u003e`\n\nHere is a summary of all the commands:\n\n|  **Command**  |                 **Description**                 |\n|---------------|-------------------------------------------------|\n| `compile`     | Runs the Livescript compiler on the source.     |\n| `test`        | Runs [Mocha](https://mochajs.org/) in BDD mode. |\n| `build`       | Runs both `compile` and `test` commands.        |\n\n## Contributing\n\nContributions are very welcome! If you'd like to contribute, these\n[guidelines](CONTRIBUTING.md) may help you.\n\n## Motivation\n\nFinding - or thinking of - a *beautiful color palette* to use in your next\nproject is such a complicated - and important - task: sometimes you've just\nlost all your creativity or sometimes you just can't get the right inspiration.\n\nThen you go search through [flat](http://flatuicolors.com/)\n[colors](http://www.flatuicolorpicker.com/)\n[websites](http://www.flatcolorsui.com/) and get tons of those - but you still\ncan't combine them in a beautiful palette.\n\nThen you find lots of those *most-wanted* inspirational palettes in\n[cool](http://flatcolors.net/palettes)\n[sites](http://www.dtelepathy.com/blog/inspiration/24-flat-designs-with-compelling-color-palettes).\nBut you still can't help yourself in choosing one amongst `2000+` options.\n\nThen you get to my problem: choosing a random color palette which I know I'm\nprobably going to appreciate - and use in my project - in `5-` minutes. Luckily\nyou also get to the solution:\n[flat-palettes](https://github.com/mabrasil/flat-palettes).\n\n## License\n\n[flat-palettes](https://github.com/mabrasil/flat-palettes) is distributed under\nthe MIT License, available in this repository. All contributions are assumed to\nbe also licensed under the MIT License.\n\n## Credits\n\nMost of the *color palettes* used in this project come from\n[flatcolors.net](http://flatcolors.net/).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fythecombinator%2Fflat-palettes","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fythecombinator%2Fflat-palettes","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fythecombinator%2Fflat-palettes/lists"}