{"id":16049325,"url":"https://github.com/bacoords/acfblocks-understrap-child","last_synced_at":"2026-06-16T12:31:12.628Z","repository":{"id":163126321,"uuid":"599657518","full_name":"bacoords/acfblocks-understrap-child","owner":"bacoords","description":null,"archived":false,"fork":false,"pushed_at":"2023-03-05T18:33:07.000Z","size":1687,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-11-14T12:02:07.279Z","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":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bacoords.png","metadata":{"files":{"readme":".github/README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.html","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":"2023-02-09T15:54:42.000Z","updated_at":"2023-05-15T16:54:45.000Z","dependencies_parsed_at":null,"dependency_job_id":"d99ef607-3d7a-4981-909b-225e3ba8dab2","html_url":"https://github.com/bacoords/acfblocks-understrap-child","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/bacoords/acfblocks-understrap-child","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bacoords%2Facfblocks-understrap-child","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bacoords%2Facfblocks-understrap-child/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bacoords%2Facfblocks-understrap-child/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bacoords%2Facfblocks-understrap-child/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bacoords","download_url":"https://codeload.github.com/bacoords/acfblocks-understrap-child/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bacoords%2Facfblocks-understrap-child/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34406819,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-16T02:00:06.860Z","response_time":126,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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-09T00:20:40.731Z","updated_at":"2026-06-16T12:31:12.609Z","avatar_url":"https://github.com/bacoords.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# understrap-child\nBasic Child Theme for Understrap Theme Framework: https://github.com/understrap/understrap\n\n## How it works\nUnderstrap Child Theme shares with the parent theme all PHP files and adds its own functions.php on top of the Understrap parent theme's functions.php.\n\n**IT DOES NOT LOAD THE PARENT THEMES CSS FILE(S)!** Instead it uses the Understrap Parent Theme as a dependency via npm and compiles its own CSS file from it.\n\nUnderstrap Child Theme uses the Enqueue method to load and sort the CSS file the right way instead of the old @import method.\n\n## Installation\n1. Install the parent theme Understrap first: `https://github.com/understrap/understrap` or `https://wordpress.org/themes/understrap/`\n   - IMPORTANT: If you download Understrap from GitHub make sure you rename the \"understrap-master.zip\" file to \"understrap.zip\" or you might have problems using this child theme!\n1. Upload the understrap-child folder to your wp-content/themes directory\n1. Go into your WP admin backend \n1. Go to \"Appearance -\u003e Themes\"\n1. Activate the Understrap Child theme\n\n## Editing\nAdd your own CSS styles to `/src/sass/theme/_child_theme.scss`\nor import you own files into `/src/sass/theme/understrap-child.scss`\n\nTo overwrite Bootstrap's or Understrap's base variables just add your own value to:\n`/src/sass/theme/_child_theme_variables.scss`\n\nFor example, the \"$primary\" variable is used by both Bootstrap and Understrap.\n\nAdd your own color like: `$primary: #ff6600;` in `/src/sass/theme/_child_theme_variables.scss` to overwrite it. This change will automatically apply to all elements that use the $brand-primary variable.\n\nIt will be outputted into:\n`/css/understrap-child.min.css` and `/css/understrap-child.css`\n\nSo you have one clean CSS file at the end and just one request.\n\nAdd your own JS to `/src/js/custom-javascript.js` to have it bundled into `/js/child-theme.js` and `/js/child-theme.min.js`. If you'd like to add additional files, you'll need to add the filenames to the Rollup.js config file: `/src/build/rollup.config.js`.\n\n## Developing With NPM, postCSS, Rollup, SASS and BrowserSync\n\nThis theme uses [sass](https://www.npmjs.com/package/sass) and [postCSS](https://postcss.org) to handle compiling all of the styles into one style sheet. The theme also includes [rollup.js](https://www.rollupjs.org/) to handle javascript compilation and minification. These choices are based on the same libraries and npm commands used in Bootstrap. In addition, it comes with [BrowserSync](http://browsersync.io) to handle live reloading while you develop.\n\n### Confused by All the CSS, SCSS, and SASS Files?\n\nSome basics about the files that come with Understrap:\n- The theme itself uses the `/style.css` file only to identify the theme inside of WordPress. The file is not loaded by the theme and does not include any styles.\n- The `/css/child-theme.css` and its minified little brother `/css/child-theme.min.css` file(s) provides all styles. It is composed of different SCSS sets and one variable file, all imported at `/src/sass/child-theme.scss`\n- Your design goes into: `/src/sass/child-theme`.\n  - Override Bootstrap by adding your variables to the `/src/sass/theme/_child_theme_variables.scss`\n  - Add your custom styles to the `/src/sass/theme/_child_theme.scss` file\n  - Or add other .scss files into it and `@import` it into `/src/sass/theme/_child_theme.scss`.\n\nThe same goes for Javascript. Just add your javascript to `/src/js/custom-javascript.js` and let rollup.js handle the rest.\n\n### Installing Dependencies\n- Make sure you have installed Node.js and BrowserSync on your computer globally\n- Open your terminal and browse to the location of your Understrap copy\n- Run: `$ npm install`\n\n### Running\nTo work and compile your Sass files on the fly start:\n\n```bash\nnpm run watch\n```\n\nOr, to run with BrowserSync:\n\nFirst change the browser-sync options to reflect your environment in the file `/build/browser-sync.config.js` in the beginning of the file:\n```javascript\nmodule.exports = {\n\t\"proxy\": \"localhost/\",\n\t\"notify\": false,\n\t\"files\": [\"./css/*.min.css\", \"./js/*.min.js\", \"./**/*.php\"]\n};\n```\n\nthen run: \n\n```bash\nnpm run watch-bs\n```\n\n\n## Bootstrap 4 Support\n\nThis child theme uses Bootstrap 5 and requires Understrap Parent Theme 1.1 or greater for best functionality. It does not create JS or CSS files that work with Bootstrap 4 markup. In fact, in the `functions.php` file, this child theme overrides the parent theme's customizer settings.\n\nIf you want to build a child theme with Bootstrap 4, please use [the 1.0.1 child theme release](https://github.com/understrap/understrap-child/releases/tag/v1.0.1) as it was the last version built to support Bootstrap 4.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbacoords%2Facfblocks-understrap-child","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbacoords%2Facfblocks-understrap-child","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbacoords%2Facfblocks-understrap-child/lists"}