{"id":18866153,"url":"https://github.com/localgovdrupal/localgov_microsites_base","last_synced_at":"2025-04-14T14:24:28.881Z","repository":{"id":37082931,"uuid":"483994790","full_name":"localgovdrupal/localgov_microsites_base","owner":"localgovdrupal","description":"Base theme for LocalGov Microsites","archived":false,"fork":false,"pushed_at":"2025-04-08T11:54:51.000Z","size":11398,"stargazers_count":0,"open_issues_count":19,"forks_count":2,"subscribers_count":6,"default_branch":"2.x","last_synced_at":"2025-04-08T12:24:46.701Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/localgovdrupal.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"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}},"created_at":"2022-04-21T09:49:35.000Z","updated_at":"2025-04-08T11:11:37.000Z","dependencies_parsed_at":"2024-05-02T15:32:58.152Z","dependency_job_id":"78e5744e-841c-4711-9248-091fe289aa08","html_url":"https://github.com/localgovdrupal/localgov_microsites_base","commit_stats":{"total_commits":201,"total_committers":10,"mean_commits":20.1,"dds":0.6019900497512438,"last_synced_commit":"728e38664a1dd2f0666faa6689f468c88bb07c73"},"previous_names":[],"tags_count":27,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/localgovdrupal%2Flocalgov_microsites_base","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/localgovdrupal%2Flocalgov_microsites_base/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/localgovdrupal%2Flocalgov_microsites_base/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/localgovdrupal%2Flocalgov_microsites_base/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/localgovdrupal","download_url":"https://codeload.github.com/localgovdrupal/localgov_microsites_base/tar.gz/refs/heads/2.x","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248895474,"owners_count":21179241,"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-11-08T05:05:43.316Z","updated_at":"2025-04-14T14:24:28.868Z","avatar_url":"https://github.com/localgovdrupal.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# LocalGov Microsites Base\n\nA  sub-theme of LocalGov Base. Please read the README there also.\n\n## Customising the appearance through the UI\n\nA _Microsite Admin_ has the permission to set a number of css variables through the UI. These override the default variables set in /css/variables.css\n\n## Creating a sub-theme of LocalGov Microsites Base\n\nWe recommend creating a sub-theme of LocalGov Microsites Base in order to create a custom theme for one or more of your microsites. A _Microsite controller_ is able to install and set a new theme for a microsite.\n\n\n## Quick overview\n\n1. Create a new sub-theme of LocalGov Microsite Base (see below)\n4. Copy the variables you need from localgov_microsites_base/css/variables.css and set the default branding colours, fonts etc\n5. Enable this theme, using the \"Enable\" button only, \u003cstrong\u003enot\u003c/strong\u003e the \"Enable and set as default\" button. After this, you can then hit the \"Set as default\" button. This 2-step process is needed to ensure all the blocks from the default theme get transition to the same block regions in your new theme.\n\n\n\n## Sub-theme\nTo create a sub-theme, you simply need to run the sub-theme creation script that is in the `/scripts` directory, like so:\n\n```bash\n  cd web/themes/contrib/localgov_microsites_base/\n  bash scripts/create_subtheme.sh\n```\n\nYou need to enter two items when creating a sub-theme:\n1. The name of the theme, this can be anything and can include spaces, e.g. Super Council\n2. The machine name for the theme, this must start with a letter and use only lowercase letters and underscores, e.g. super_council\n\n## Custom Styles\nHopefully most of the custom styles you will need are set via CSS custom properties in the `/css/variables.css` file in your sub-theme.\n\nThis is where you set your colours, fonts, spacing, etc. Then you \"apply\" these variables where needed, like so:\n\n```css\n  :root {\n    /* Set/Override Variables */\n    --color-accent: red;\n    --spacing-largest: 5rem;\n\n    /* Apply Variables */\n    --color-link: var(--color-accent);\n    --breadcrumbs-background-color: var(--color-accent);\n    --section-spacing-vertical-header: var(--spacing-largest);\n  }\n```\n\nIf you need to add any CSS overides, you can create custom CSS files for these and then a library/libraries to attach them to your components.\n\n\n## Maintainers\n\nThis project is currently maintained by:\n\n - Mark Conroy https://github.com/markconroy\n - Maria Young https://github.com/msayoung\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flocalgovdrupal%2Flocalgov_microsites_base","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flocalgovdrupal%2Flocalgov_microsites_base","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flocalgovdrupal%2Flocalgov_microsites_base/lists"}