{"id":14954970,"url":"https://github.com/mishterk/wp-tailwindcss-theme-boilerplate","last_synced_at":"2025-04-06T06:09:00.919Z","repository":{"id":39320323,"uuid":"221607284","full_name":"mishterk/wp-tailwindcss-theme-boilerplate","owner":"mishterk","description":"A minimalist boilerplate for WordPress theme development using Tailwind CSS, SCSS, and Laravel Mix.","archived":false,"fork":false,"pushed_at":"2023-01-05T00:50:18.000Z","size":2546,"stargazers_count":371,"open_issues_count":24,"forks_count":76,"subscribers_count":17,"default_branch":"master","last_synced_at":"2025-03-30T05:06:17.129Z","etag":null,"topics":["laravelmix","tailwind","tailwind-css","tailwindcss","wordpress","wordpress-boilerplate","wordpress-development","wordpress-starter-theme","wordpress-theme"],"latest_commit_sha":null,"homepage":"https://philkurth.com.au/articles/wordpress-theme-using-tailwind-css/","language":"JavaScript","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/mishterk.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}},"created_at":"2019-11-14T03:53:57.000Z","updated_at":"2025-03-16T09:24:45.000Z","dependencies_parsed_at":"2023-02-03T02:30:53.942Z","dependency_job_id":null,"html_url":"https://github.com/mishterk/wp-tailwindcss-theme-boilerplate","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mishterk%2Fwp-tailwindcss-theme-boilerplate","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mishterk%2Fwp-tailwindcss-theme-boilerplate/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mishterk%2Fwp-tailwindcss-theme-boilerplate/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mishterk%2Fwp-tailwindcss-theme-boilerplate/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mishterk","download_url":"https://codeload.github.com/mishterk/wp-tailwindcss-theme-boilerplate/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247441052,"owners_count":20939239,"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":["laravelmix","tailwind","tailwind-css","tailwindcss","wordpress","wordpress-boilerplate","wordpress-development","wordpress-starter-theme","wordpress-theme"],"created_at":"2024-09-24T13:10:19.110Z","updated_at":"2025-04-06T06:09:00.902Z","avatar_url":"https://github.com/mishterk.png","language":"JavaScript","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"readme":"A boilerplate for WordPress theme development using [TailwindCSS](https://tailwindcss.com/) and [Laravel Mix](https://laravel.com/docs/5.8/mix).\n\n## Getting started:\n\n1. `cd` into your `wp-content/themes` directory\n1. Run `git clone https://github.com/mishterk/wp-tailwindcss-theme-boilerplate.git \u003ctheme-name-here\u003e` to clone this repo into a new theme.\n   - Be sure to substitute `\u003ctheme-name-here\u003e` with your desired theme name.\n1. `cd` into your new theme directory\n1. Run `npm install`\n1. Duplicate the `local-example.json` file to `local.json`, then replace the `proxy` value with your local \ndevelopment hostname\n   - This will allow you to use live reload/injection while working on your CSS/JS\n1. Run a search \u0026 replace across the theme to replace all instances of 'WpTailwindCssThemeBoilerplate' with a PHP \nnamespace specific to your theme/project\n1. Change the theme information in `style.css`\n1. Activate your theme\n1. Run `npm run dev` and start coding\n   \n## Commands\n\n#### `npm run dev`\n\nAssets will be compiled and BrowserSync will proxy the dev host allowing you to work while seeing your CSS and JS changes appear on the site as they are recompiled.\n\n#### `npm run webpack`\n\nRuns the development build\n\n#### `npm run prod`\n\nRuns the product build which includes asset file versioning and Purge CSS \n\n## Versioned Assets\n\nVersioned assets will appear in a `build` directory alongside a manifest file which is used while \n[enqueuing scripts and styles](https://github.com/mishterk/wp-laravel-mix-theme-boilerplate/blob/master/includes/scripts-and-styles.php).\nThis saves you the need to adjust version parameters on your assets and makes it possible to remove parameters on \nasset URLs without losing the ability to force those assets to update in browsers.\n\n## Purge CSS\n\nPurge CSS is pretty darn excellent and is used to strip out any CSS that isn't being used during the production build. \n\nIt does this by looking through specified template files to work out which CSS selectors have been used. If it can't \nfind a CSS rule being used in the templates, it removes it from the final CSS. \n\nSee the `paths` option in the `mix.purgeCss()` invocation in `webpack.mix.js` for the file paths being looked at. \n\n### How to tell Purge CSS to ignore things\n\nThe easiest way is to delineate your CSS with comments as per the example below. See \n[safelisting](https://purgecss.com/safelisting.html) for more options.   \n\n```css\n/* purgecss start ignore */\nh1 {\n  color: blue;\n}\n\nh3 {\n  color: green;\n}\n/* purgecss end ignore */\n```\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmishterk%2Fwp-tailwindcss-theme-boilerplate","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmishterk%2Fwp-tailwindcss-theme-boilerplate","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmishterk%2Fwp-tailwindcss-theme-boilerplate/lists"}