https://github.com/madrilene/wp-excellent

Starter for classic PHP WordPress theme. Based on the workflow suggested by Andy Bell's buildexcellentwebsit.es.
https://github.com/madrilene/wp-excellent

buildexcellentwebsites every-layout tailwindcss wordpress wordpress-starter-theme wordpress-theme

Last synced: 20 days ago
JSON representation

Starter for classic PHP WordPress theme. Based on the workflow suggested by Andy Bell's buildexcellentwebsit.es.

• Host: GitHub
• URL: https://github.com/madrilene/wp-excellent
• Owner: madrilene
• License: other
• Created: 2022-07-25T10:25:08.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2024-09-16T08:55:33.000Z (2 months ago)
• Last Synced: 2024-10-11T00:15:28.698Z (about 1 month ago)
• Topics: buildexcellentwebsites, every-layout, tailwindcss, wordpress, wordpress-starter-theme, wordpress-theme
• Language: PHP
• Homepage:
• Size: 1.57 MB
• Stars: 9
• Watchers: 2
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.MD

Awesome Lists containing this project

README

        
# wp-excellent

Starter for classic PHP WordPress theme.

Based on the workflow suggested by Andy Bell's https://buildexcellentwebsit.es/.

## Contents

- [Using this](#using-this)

- [Credits](#credits)

## Using this

Edit CSS and JS in `_resources`. Fonts and images in `assets`.

For production run production build and upload in your theme folder:

- assets

- core

- css

- js

- template-parts

- Wordpress PHP files

- screenshot.jpg

- style.css

## Install dependencies

```

- npm install

```

### Working with browser-sync

Creates a dev server (browser-sync) with hot reload on **localhost:3000**, pointing to the domain created by _LocalWP_. The domain (eg "wp-excellent.local", "localhost:10028", etc.) must correspond to the "site host" created by Local. Change both occurrences of "localhost:10028" in the `scripts` section of `package.json`:

```json

"browser-sync": "browser-sync start --proxy \"localhost:10028\" --host=\"localhost:10028\" --no-inject-changes --files=\"./\"",

```

I might change that in the future, as LocalWP now offers hot [reload out of the box](https://localwp.com/help-docs/local-features/instant-reload/). But for now it only watches wp-content/plugins and wp-content/themes for changes to .css files.

```

npm start

```

## Creating a production build

```

npm run production

```

## Credits

**Andy Bell**

Andy recently came up an approach that incorporates Tailwind CSS into his methodology.

- https://cube.fyi/

- https://buildexcellentwebsit.es/

**Heydon Pickering**

I really like Heydon's approaches and recommend reading his books.

- https://every-layout.dev/

- https://inclusive-components.design/

**Tailwind**

- https://tailwindcss.com/