{"id":13695023,"url":"https://github.com/jmjuanes/siimple","last_synced_at":"2025-12-12T04:21:16.566Z","repository":{"id":34918314,"uuid":"38970398","full_name":"jmjuanes/siimple","owner":"jmjuanes","description":"The minimal and themeable CSS toolkit for flat and clean designs","archived":false,"fork":false,"pushed_at":"2024-01-10T19:51:30.000Z","size":5652,"stargazers_count":659,"open_issues_count":2,"forks_count":54,"subscribers_count":21,"default_branch":"main","last_synced_at":"2025-05-09T04:01:43.936Z","etag":null,"topics":["css","css-framework","css-in-js","flat","minimal","siimple","themeable","utilities-css"],"latest_commit_sha":null,"homepage":"http://www.siimple.xyz","language":"JavaScript","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/jmjuanes.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","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},"funding":{"github":"jmjuanes"}},"created_at":"2015-07-12T17:15:41.000Z","updated_at":"2025-05-07T20:03:54.000Z","dependencies_parsed_at":"2022-07-18T03:30:43.979Z","dependency_job_id":"bc1172b3-df1c-4031-9515-b0b06d1bc8b8","html_url":"https://github.com/jmjuanes/siimple","commit_stats":{"total_commits":3726,"total_committers":18,"mean_commits":207.0,"dds":0.08534621578099844,"last_synced_commit":"97f3a0da65bef1b589f6d85ec8c4ac5ffca40538"},"previous_names":["siimple/siimple"],"tags_count":44,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jmjuanes%2Fsiimple","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jmjuanes%2Fsiimple/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jmjuanes%2Fsiimple/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jmjuanes%2Fsiimple/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jmjuanes","download_url":"https://codeload.github.com/jmjuanes/siimple/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254384988,"owners_count":22062422,"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":["css","css-framework","css-in-js","flat","minimal","siimple","themeable","utilities-css"],"created_at":"2024-08-02T17:01:57.506Z","updated_at":"2025-12-12T04:21:16.531Z","avatar_url":"https://github.com/jmjuanes.png","language":"JavaScript","funding_links":["https://github.com/sponsors/jmjuanes"],"categories":["JavaScript","Frameworks / Resources"],"sub_categories":["S"],"readme":"![Siimple header](./header.svg)\n\n[![NPM Version](https://badgen.net/npm/v/siimple)](https://npmjs.com/package/siimple)\n[![Follow @siimplecss](https://badgen.net/badge/Twitter/siimplecss/blue)](https://twitter.com/siimplecss)\n[![Get help](https://badgen.net/badge/Discussions/Join%20us/cyan)](https://github.com/jmjuanes/siimple/discussions)\n[![MIT License](https://badgen.net/github/license/jmjuanes/siimple)](https://github.com/jmjuanes/siimple)\n[![PRs welcome](https://badgen.net/badge/PR/Welcome/green)](https://github.com/jmjuanes/siimple)\n[![CI](https://github.com/jmjuanes/siimple/actions/workflows/ci.yml/badge.svg)](https://github.com/jmjuanes/siimple/actions/workflows/ci.yml)\n\nWelcome to the **siimple CSS toolkit** repository :tada: \n\n- :books: **Documentation**: https://www.siimple.xyz.\n- :pencil: **Try siimple**: play with **siimple** in your browser with our [online playground](https://www.siimple.xyz/playground).\n- :pray: **Contributing**: check out our [CONTRIBUTING guide](/CONTRIBUTING.md) to get started.\n- :question: **Questions**: join our [discussion forum](https://github.com/jmjuanes/siimple/discussions).\n- :sparkles: **Releases**: check out our [latest releases](https://github.com/jmjuanes/siimple/releases).\n- :leftwards_arrow_with_hook: Documentation for **v3**: [v3.siimple.xyz](https://v3.siimple.xyz).\n\n## What is siimple\n\nWe call **siimple** a **CSS toolkit** because it is a themeable and customizable CSS framework, but also a CSS engine that you can use for building your own CSS framework.\n\nInspired by other CSS frameworks (like [bulma](https://bulma.io)), but:\n\n- **Fully themeable**: use your own theme to customize and extend **siimple**. \n- **Use what you really need**: include the core modules (elements, helpers, ...) and themes that you **REALLY** need for your project.\n- **No dependencies**: written all from scratch without any dependencies.\n- **No CSS preprocessors needed**: we provide a tiny CLI to compile the CSS, so you do not need any other preprocessor like SASS or LESS.\n- **Color palette included**: we provide a flat color palette to customize **siimple** with different colors.\n- **Pure CSS icons included**: we provide a collection of pure CSS icons.\n\n## Packages\n\nAlong with `siimple` and `siimple-icons` packages, the packages listed in the table below are also available on this repository. These packages are published in the `@siimple` organization in [npm](https://npmjs.com).\n\n| Package | Description | Included in `siimple` |\n|---------|-------------|:---------------------:|\n| [@siimple/core](https://github.com/jmjuanes/siimple/tree/main/packages/core/) | Core engine of the siimple CSS toolkit. | :heavy_check_mark: |\n| [@siimple/modules](https://github.com/jmjuanes/siimple/tree/main/packages/modules/) | Core modules of siimple. | :heavy_check_mark: |\n| [@siimple/colors](https://github.com/jmjuanes/siimple/tree/main/packages/colors/) | Color palette for siimple. | :heavy_check_mark: |\n| [@siimple/cli](https://github.com/jmjuanes/siimple/tree/main/packages/cli/) | Command line for siimple. | :heavy_check_mark: |\n| [@siimple/postcss](https://github.com/jmjuanes/siimple/tree/main/packages/postcss/) | PostCSS plugin for siimple. | :heavy_check_mark: |\n| [@siimple/presets](https://github.com/jmjuanes/siimple/tree/main/packages/presets/) | A collection of all official presets for siimple. | :x: |\n| [@siimple/preset-base](https://github.com/jmjuanes/siimple/tree/main/packages/preset-base/) | Base theme of siimple. | :heavy_check_mark: |\n| [@siimple/preset-dark](https://github.com/jmjuanes/siimple/tree/main/packages/preset-dark/) | Dark theme for siimple. | :x: |\n| [@siimple/preset-ice](https://github.com/jmjuanes/siimple/tree/main/packages/preset-ice/) | A frosty and clean theme for siimple. | :x: |\n| [@siimple/preset-noir](https://github.com/jmjuanes/siimple/tree/main/packages/preset-noir/) | Classic and elegant theme for siimple. | :x: |\n| [@siimple/preset-mustard](https://github.com/jmjuanes/siimple/tree/main/packages/preset-mustard/) | Yellowish and very clean theme preset. | :x: |\n| [@siimple/standalone](https://github.com/jmjuanes/siimple/tree/main/packages/standalone/) | Run siimple directly in the browser. | :x: |\n| [@siimple/icons](https://github.com/jmjuanes/siimple/tree/main/packages/icons/) | Siimple icons in JSON format. | :x: |\n\nThe version of these packages are different from the main `siimple` and `siimple-icons` packages, but follows this convention: the version `4.x.y` of `siimple` equals to version `0.x.y` of all packages published in the `@siimple` organization.\n\n## Development\n\nHere are the instructions for building **siimple** from the source code. Before you get started, ensure you have [Node 14 and Yarn](https://nodejs.org/en/download/) installed in your computer.\n\nFirst clone this repository in your local machine running the following command:\n\n```bash\n$ git clone https://github.com/jmjuanes/siimple\n```\n\nNavigate into the repository folder and then install dependencies with **yarn**:\n\n```bash\n$ yarn install\n```\n\n### Build siimple and siimple-icons\n\nRun the following command to build the **siimple** CSS framework in `siimple/siimple.css` and the **siimple-icons** CSS in `siimple-icons/siimple-icons.css`:\n\n```bash\n$ yarn run build\n```\n\n### Documentation\n\nWe are using [Gatsby](https://www.gatsbyjs.com/) for documentation. After building the CSS of the **siimple** framework you can build the documentation site with the following command:\n\n```bash\n$ yarn run build:website\n```\n\nStart the website server with the following command:\n\n```bash\n$ yarn run serve\n```\n\n### Playground\n\nYou can build our playground tool as a standalone web application with the following command:\n\n```bash\n$ yarn run build:playground\n```\n\nThis will generate a new folder `playground/public` with the code of the playground app. Start the playground web service with the following command:\n\n```bash\n$ yarn run start:playground\n``` \n\n## Acknowledgements\n\n- CSS naming methodology based on [SMACSS](http://smacss.com).\n- CSS-In-JS engine inspired by [Emotion](https://emotion.sh) and [Stitches](https://stitches.dev).\n- Theme configuration and presets demo inspired by [Theme UI](https://theme-ui.com) and [System UI](https://system-ui.com).\n- Standalone package inspired by [Babel Standalone](https://babel.dev).\n\n## License\n\nCode and documentation of **siimple** \u0026copy; 2015-present **Josemi Juanes**. Code released under the [MIT license](./LICENSE). Documentation released under [Creative Commons Attribution 4.0](https://creativecommons.org/licenses/by/4.0/).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjmjuanes%2Fsiimple","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjmjuanes%2Fsiimple","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjmjuanes%2Fsiimple/lists"}