{"id":26891641,"url":"https://github.com/iocss/crossass-config","last_synced_at":"2025-12-12T04:07:01.335Z","repository":{"id":14440349,"uuid":"17151793","full_name":"iocss/crossass-config","owner":"iocss","description":"A dot-syntax configuration (Map) library for Sass (mixin / function).","archived":false,"fork":false,"pushed_at":"2015-07-01T12:42:32.000Z","size":208,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-10T03:56:26.217Z","etag":null,"topics":["config","configuration","css","function","functions","library","mixin","mixins","option","options","sass","setting","settings"],"latest_commit_sha":null,"homepage":"","language":"CSS","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/iocss.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-02-24T21:41:25.000Z","updated_at":"2025-03-05T09:15:00.000Z","dependencies_parsed_at":"2022-08-30T20:10:41.496Z","dependency_job_id":null,"html_url":"https://github.com/iocss/crossass-config","commit_stats":null,"previous_names":["whizark/crossass-config"],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iocss%2Fcrossass-config","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iocss%2Fcrossass-config/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iocss%2Fcrossass-config/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iocss%2Fcrossass-config/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/iocss","download_url":"https://codeload.github.com/iocss/crossass-config/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246552965,"owners_count":20795835,"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":["config","configuration","css","function","functions","library","mixin","mixins","option","options","sass","setting","settings"],"created_at":"2025-03-31T22:41:06.997Z","updated_at":"2025-12-12T04:06:56.045Z","avatar_url":"https://github.com/iocss.png","language":"CSS","readme":"# Crossass Configuration\n\nA dot-syntax configuration (Map) library for Sass.\n\n```scss\n// This is the same as:\n// (\n//     color: (\n//         fg: black\n//     )\n// )\n$include x-config-set('color.fg', black);\n\nbody {\n    color: x-config-get('color.fg');  // black\n}\n// So you can also get the raw Map by the path.\n// x-config-get('color') returns:\n// (\n//     fg: black\n// )\n```\n\n## Features\n\n* Dot-syntax configuration\n* Default configuration support\n\n## Requirement\n\n* [Sass](http://sass-lang.com/) 3.3.0+\n\n## Installation\n\n```sh\nbower install crossass-config\n```\n\nor just copy ```crossass-config``` folder into your project.\n\n## Usage\n\n### Import\n\n```scss\n@import 'bower_components/crossass-config/scss/config';\n```\n\nor\n\n```scss\n@import 'your-folder/crossass-config/scss/config';\n```\n\n### Default configuration setting\n\n```scss\n// _your-partial-file.scss\n\n// Default configuration settings\n// Passing true to the 3rd parameter,\n// the value is assigned to the configuration path as the default\n@include x-config-set('color.fg', black, true);\n@include x-config-set('color.bg', white, true);\n\n// or assign values to a configuration path by using Map\n// @include x-config-set('color', (fg: black, bg: white), true);\n```\n\n### Getting configuration setting\n\n```scss\n// your-project-file.scss\n\n@import 'bower_components/crossass-config/scss/config';\n@import 'your-partial-file';\n\nbody {\n    color: x-config-get('color.fg');  // black\n    background-color: x-config-get('color.bg');  // white\n}\n```\n\n### Overriding default configuration\n\n```scss\n// your-project-file.scss\n\n@import 'bower_components/crossass-config/scss/config';\n@import 'your-partial-file';\n\n// Overriding default configuration\n@include x-config-set('color.fg', #666666);\n\nbody {\n    color: x-config-get('color.fg');  // #666666\n    background-color: x-config-get('color.bg');  // white\n}\n```\n\n### Compatibility\n\nx-config-get(), x-config-set() can be compatible with Sass variable.\n\n```scss\n@import 'bower_components/crossass-config/scss/config';\n\n// Variables\n$color-fg: black !default;\n$color-bg: white !default;\n$color: (\n    fg: $color-fg,\n    bg: $color-bg\n) !default;\n\n// x-config-set()\n@include x-config-set('color', $color, true);\n\nbody {\n    color: x-config-get('color.fg');  // black\n    background-color: x-config-get('color.bg');  // white\n}\n```\n\n### Map vs x-config-get(), x-config-set()\n\n```scss\n@import 'bower_components/crossass-config/scss/config';\n\n// Map\n$config: (\n    button: (\n        color: (\n            fg: white,\n            bg: blue\n        )\n    )\n);\n\n// x-config-set()\n$include x-config-set('button.color.fg', white);\n$include x-config-set('button.color.bg', blue);\n\n// Map\n.map {\n    color: map-get( map-get( map-get( $config, 'button' ), 'color' ), 'fg' );\n    background-color: map-get( map-get( map-get( $config, 'button' ), 'color' ), 'bg' );\n}\n\n// x-config-get()\n.x-config {\n    color: x-config-get('button.color.fg');\n    background-color: x-config-get('button.color.bg');\n}\n```\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiocss%2Fcrossass-config","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fiocss%2Fcrossass-config","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiocss%2Fcrossass-config/lists"}