{"id":14982102,"url":"https://github.com/simonpadbury/b4st","last_synced_at":"2025-04-05T20:08:57.677Z","repository":{"id":73601002,"uuid":"45668067","full_name":"SimonPadbury/b4st","owner":"SimonPadbury","description":"A Bootstrap 4 Starter Theme, for WordPress","archived":false,"fork":false,"pushed_at":"2023-02-18T10:12:01.000Z","size":9512,"stargazers_count":311,"open_issues_count":1,"forks_count":105,"subscribers_count":48,"default_branch":"master","last_synced_at":"2025-04-05T20:08:47.913Z","etag":null,"topics":["bootstrap4","fontawesome5","gulp","gulp-sass","gutenberg","starter-theme","wordpress"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"unlicense","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SimonPadbury.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}},"created_at":"2015-11-06T08:03:10.000Z","updated_at":"2024-05-19T10:37:33.000Z","dependencies_parsed_at":null,"dependency_job_id":"7cb77137-e482-4533-a2a0-e724f33a23bb","html_url":"https://github.com/SimonPadbury/b4st","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SimonPadbury%2Fb4st","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SimonPadbury%2Fb4st/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SimonPadbury%2Fb4st/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SimonPadbury%2Fb4st/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SimonPadbury","download_url":"https://codeload.github.com/SimonPadbury/b4st/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247393572,"owners_count":20931813,"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":["bootstrap4","fontawesome5","gulp","gulp-sass","gutenberg","starter-theme","wordpress"],"created_at":"2024-09-24T14:04:47.839Z","updated_at":"2025-04-05T20:08:57.659Z","avatar_url":"https://github.com/SimonPadbury.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# b4st – A Bootstrap 4 Starter Theme, for WordPress\n\n*Version 3.1*\n\n[https://github.com/SimonPadbury/b4st](https://github.com/SimonPadbury/b4st)\n\n------------------\n\nInterested in **Bootstrap 5**? Then go for https://github.com/SimonPadbury/b5st\n\n------------------\n\n\u003e b4st is a simple, Gutenberg-compatible WordPress starter theme loaded with Bootstrap 4 and Font Awesome 5 — using Gulp for preprocessing its SCSS into CSS.\n\n## Basic features\n\n* [UNLICENCE](http://unlicense.org) (open source).\n\n* Simple, intuitive, clean code. Theme CSS and JS, functions and loops are organized into different folders.\n\n* A starter CSS theme – `/theme/css/b4st.css`, enqueued. (Note: do not put your styles in `styles.css`, because that is not enqueued.)\n\n* `b4st.css` is generated from SCSS using Gulp and NodeJS packages. The SCSS files are also included.\n\n* Sass (actually, SCSS) preprocessed to `b4st.css` by Gulp (or you can do your own thing).\n\n* A starter JS script – `theme/css/b4st.js`, enqueued.\n\n* Dimox breadcrumbs ([http://dimox.net/wordpress-breadcrumbs-without-a-plugin/](http://dimox.net/wordpress-breadcrumbs-without-a-plugin/)).\n\n* A [CSS lock](https://fvsch.com/css-locks/) gradually enlarges the typographic font sizes from base 16px to 20px for larger viewports. This affects headers, paragraphs, lists, tables, etc. but not buttons and forms.\n\n## Dependencies\n\n* WordPress.\n\n* Served from CDN’s:\n    * Modernizr 2.8.3\n    * jQuery 3.5.1 (full, not slim version)\n    * Popper 1.16.1 (needed by Bootstrap popovers, tooltips and collapsed navbar “hamburger” action)\n    * Bootstrap 4.5.1 CSS\n    * Bootstrap 4.5.1 JS\n    * Font Awesome 5.14.0\n\n* **Optional** (install these if you want to Gulp-Sass for preprocessing the SCSS files):\n    * NodeJS\n    * Gulp-CLI – installed globally\n    * Node packages for the following devDependencies:\n        * autoprefixer\n        * cssnano\n        * gulp\n        * gulp-postcss\n        * gulp-sass\n        * gulp-sourcemaps\n\n## Bootstrap Integration\n\n* Bootstrap navbar with WordPress menu and search.\n\t* Navbar dropdowns (child menus) are handled by a [custom walker nav menu class](https://github.com/SimonPadbury/b4st/blob/master/functions/navbar.php).\n\n* Bootstrap customized comments and feedback response form.\n\n## Gutenberg Compatibility\n\n* Gutenberg editor stylesheet – into which has been copy-pasted the typography styles from Bootstrap 4’s _Reboot_ CSS (see [http://getbootstrap.com/docs/4.3.1/content/reboot/](http://getbootstrap.com/docs/4.1/content/reboot/)).\n\n* \u003cmark\u003eSince v.3.0, b4st (this theme) has adopted a narrow single-column layout, so that it can make use of Gutenberg’s extra-wide and full width blocks.\u003c/mark\u003e In the front-end CSS, these are handled by a variation on Andy Bell’s [full bleed](https://hankchizljaw.com/wrote/creating-a-full-bleed-css-utility/) utility.\n    * **Optional:** If you wish to revert the font-end templates to a two-column (main content plus sidebar) layout, these are still available in the templates but commented out. However, you will also need to remove (or comment out) support for Gutenberg’s extra-wide and full-width comment blocks from the functions, and modify the CSS a little bit.\n\n## Child-Theme Friendly\n\nb4st was not originally designed for child theming — it is a starter theme modifying directly. Most people still use it that way. But as child theme-friendliness has been asked for, here it is:\n\n* Many functions are pluggable.\n\n* Theme [hooks](/functions/hooks.php) – paired _before_ and _after_ the navbar, post/page main, (optional sidebar) and footer. Parent theme hooks are able to recieve [actions](https://developer.wordpress.org/plugins/hooks/actions/) from a child theme.\n\n* Also, the navbar brand, navbar search form and sub-footer “bottomline” are inserted using pluggable hooks. So, a child theme can override these.\n\n* _Documentation on b4st theme hooks can be found in the [wiki](https://github.com/SimonPadbury/b4st/wiki/b4st-Theme-Hooks)._\n\n## Using the Gulp Task-Runner to Preprocess SCSS into CSS\n\nSince v.3.0, in the `theme/` folder there is a `scss/` folder containing all the SCSS files that have been used to create the file `theme/css/b4st.css`.\n\nYou can (beautify and) edit that file directly — or you can preprocess the SCSS files using whatever you prefer to use.\n\nIn order to use Gulp, you need to:\n\n1. Install [NodeJS](https://nodejs.org/).\n\n2. Install [Gulp-CLI](https://gulpjs.com/docs/en/getting-started/quick-start) globally, using your terminal:\n\n```\nnpm install --global gulp-cli\n```\n\n3. In b4st there are already these files that you need: `gulpfile.js`, `package.json` and `package-lock.json`. Therefore what you need next are the Node packages. To get these, you need to `cd` to the b4st theme’s root folder and do an `npm install` in your terminal:\n\n```\nnpm install\n```\n\n4. A few minutes later, with all the `node_modules/` installed as local dev dependencies (as you can see from the 'package.json` these are: autoprefixer, cssnano, gulp, gulp-postcss, gulp-sass, and gulp-sourcemaps), you should simply be able to run gulp by typing this in your terminal:\n\n```\ngulp\n```\n\nThat’s it.\n\nYou can stop Gulp by typing `ctrl+C` (hold the **control** key down and press the **c** key).\n\n5. So, in development, you could have WordPress running on a local server (e.g. BitNami-WordPress, AMPPS, Local by Flywheel, or MAMP + WordPress), and this Gulp setup watching and processing your SCSS into CSS.\n    * You may sometimes need to purge your browser cache at the start of a dev/design session, so that it reloads your newer stylesheet.\n\n---\n\nSee the [LOG.md](/LOG.md)\n\nSee the [b4st Wiki](https://github.com/SimonPadbury/b4st/wiki).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimonpadbury%2Fb4st","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsimonpadbury%2Fb4st","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimonpadbury%2Fb4st/lists"}