PHPackages                             webdevstudios/wd\_s - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. webdevstudios/wd\_s

ActiveWordpress-theme

webdevstudios/wd\_s
===================

A starter theme from WebDevStudios.

v4.0(2y ago)65843135[12 issues](https://github.com/WebDevStudios/wd_s/issues)[9 PRs](https://github.com/WebDevStudios/wd_s/pulls)GPL-2.0-or-laterPHPCI passing

Since Aug 19Pushed 2y ago51 watchersCompare

[ Source](https://github.com/WebDevStudios/wd_s)[ Packagist](https://packagist.org/packages/webdevstudios/wd_s)[ RSS](/packages/webdevstudios-wd-s/feed)WikiDiscussions main Synced 6d ago

READMEChangelog (6)Dependencies (6)Versions (40)Used By (0)

wd\_s
======

[](#wd_s-)

[![Build Status](https://camo.githubusercontent.com/29c3a048fb763a8881ab2121b5bdea1317a6001909f5290b45d49cc03e325a2c/68747470733a2f2f696d672e736869656c64732e696f2f656e64706f696e742e7376673f75726c3d6874747073253341253246253246616374696f6e732d62616467652e6174726f782e64657625324677656264657673747564696f7325324677645f7325324662616467652533467265662533446d61696e267374796c653d666c6174)](https://github.com/WebDevStudios/wd_s/actions)

A starter theme from WebDevStudios.

[![WebDevStudios. Your Success is Our Mission.](https://camo.githubusercontent.com/42f2d2ee1fd163a35dfde75884c89f308d0ae014e313bd3050caa1b98bfde9c6/68747470733a2f2f77656264657673747564696f732e636f6d2f77702d636f6e74656e742f75706c6f6164732f323031382f30342f7764732d6769746875622d62616e6e65722e706e67)](https://webdevstudios.com/contact/)

Table of Contents
------------------

[](#table-of-contents-)

- [Introduction](#introduction)
- [Getting Started](#getting-started)
    - [Prerequisites](#prerequisites)
    - [Quick Start](#quick-start)
    - [Advanced](#advanced)
- [Setup](#setup)
    - [Development](#development)
- [Contributing and Support](#contributing-and-support)

Introduction
------------

[](#introduction)

Hello there! I am a versatile starter theme known as `wd_s`, or `wdunderscores`. My foundation is built primarily on PHP templates, but I offer the flexibility to incorporate custom templates through the Site Editor. It's worth noting that I'm designed for customization, so it's best not to use me as a Parent Theme. Instead, harness my potential to transform me into the most amazing WordPress theme you can envision – that's what I'm here for!

I come equipped with a host of robust web technologies, including [Tailwind](https://www.tailwindcss.com), [npm](https://www.npmjs.com/), [webpack](https://webpack.js.org/), [Sass](http://sass-lang.com/), and [PostCSS](https://github.com/postcss/postcss). To ensure your code aligns with [WordPress standards](https://make.wordpress.org/core/handbook/best-practices/coding-standards/) and stays clean, I leverage [@wordpress/scripts](https://developer.wordpress.org/block-editor/packages/packages-scripts/) for CSS and JavaScript linting. What's more, I take accessibility seriously and proudly comply with both WCAG 2.1AA and Section 508 standards right from the start.

I also come with the Site Editor activated, providing you with even more versatility and ease in crafting your WordPress theme. Whether you're customizing templates or utilizing the Site Editor, I'm here to support your creative journey. And remember, I do require at least PHP 8.0 to be activated to unlock my full potential.

Getting Started
---------------

[](#getting-started)

### Prerequisites

[](#prerequisites)

Because I compile and bundle assets via NPM scripts, basic knowledge of the command line and the following dependencies are required:

- [Node](https://nodejs.org) (v18+)
- [NPM](https://npmjs.com) (v9+)
- [Composer](https://getcomposer.org/)

### Quick Start

[](#quick-start)

If you want to keep it simple, head over to  and generate your `wd_s` based theme from there. You just input the name of the theme you want to create, click the "Generate" button, and you get your ready-to-awesomize starter theme. Alternatively, you could download a pre-built [ZIP](http://wdunderscores.com/wp-content/themes/wdunderscores/inc/prototype/wd_s.zip)

### Advanced

[](#advanced)

If you want to set me up manually:

1. [Download](http://wdunderscores.com/wp-content/themes/wdunderscores/inc/prototype/wd_s.zip) and extract the zip into your `wp-content/themes` directory and rename `wd_s` to fit your needs.
2. Find &amp; Replace

You'll need to change all instances of the name: `wd_s`.

- Search for: `@package wd_s` and replace with: `@package project_name` to capture the package name
- Update `"WebDevStudios\wd_s,wd_s"` to: `"CompanyName\project_name,project_name"` (with double quotes) in phpcs.xml.dist
- Search for: `WebDevStudios\wd_s` and replace with: `CompanyName\project_name` to capture the namespaces
- Update `"webdevstudios/wd_s"` to `"companyname/project_name"` (with double quotes) in composer.json
- Search for: `, 'wd_s'` and replace with: `, 'project_name'` (inside backticks) to capture the text domain
- Update `Text Domain: wd_s` to: `Text Domain: project_name` in style.css
- Update `"wd_s"` to: `"project_name"` (with double quotes) in phpcs.xml.dist and package.json
- Update `'wd_s'` to: `'project_name'` (with single quotes) in inc/setup/setup.php
- Search for: `wd_s_` and replace with: `project_name_` to capture all the function names
- Search for: `'wd_s-` and replace with: `'project_name-` to capture prefixed handles
- Search for `wd_s.pot` and replace with: `project_name.pot` to capture translation files
- Search for `wdunderscores.test` and replace with: `project_name.test` to match your local development URL
- Edit the theme information in the header of style.scss to meet your needs

Setup
-----

[](#setup)

From the command line, change directories to your new theme directory:

```
cd /wp-content/themes/your-theme
```

Install theme dependencies and trigger an initial build.

> Note: You will need to have Composer 2 and NPM 9 installed first.

```
npm i && composer i
```

### Development

[](#development)

From the command line, type any of the following to perform an action:

CommandAction`npm run watch`Builds assets and starts Live Reload and Browsersync servers`npm run start`Builds assets and starts Live Reload server`npm run build`Builds production-ready assets for a deployment`npm run lint`Check all CSS, JS, MD, and PHP files for errors`npm run format`Fix all CSS, JS, MD, and PHP formatting errors automatically`npm run report`Gives detailed information on coding standards violations in PHP code### Building a block with wpcli

[](#building-a-block-with-wpcli)

In order to build a block, run the following wpcli script.

Note: If you're using Local, you can open the shell from within Local to do this. `Sitename -> Open site shell`.

```
wp wds create_portable_block myblock --title="This is myblock" --desc="This block is used for wds." --keyword="myblock" --icon="table-row-before" --namespace="wds"
```

This will scaffold out a block inside of the `blocks` folder in the theme. Replace `myblock` with the name of your block and update the other items `title`, `desc`, `keyword`, `icon`, `namespace` with the appropriate information.

Note: If you don't see your new block available under the block listing in the editor after following the above steps, try changing the namespacing in your block's `block.json` to the following format `your-namespace/blockname` and check again.

Contributing and Support
------------------------

[](#contributing-and-support)

Your contributions and [support tickets](https://github.com/WebDevStudios/wd_s/issues) are welcome. Please see our [contributing guidelines](https://github.com/WebDevStudios/wd_s/blob/main/CONTRIBUTING.md) before submitting a pull request.

wd\_s is free software, and is released under the terms of the GNU General Public License version 2 or any later version. See [LICENSE.md](https://github.com/WebDevStudios/wd_s/blob/main/LICENSE.md) for complete license.

###  Health Score

40

—

FairBetter than 88% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity32

Limited adoption so far

Community34

Small or concentrated contributor base

Maturity67

Established project with proven stability

 Bus Factor3

3 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~215 days

Recently: every ~263 days

Total

6

Last Release

961d ago

Major Versions

2.1 → 3.02022-07-29

v3.5 → v4.02023-09-29

### Community

Maintainers

![](https://www.gravatar.com/avatar/1871eb9cf5592f9aef06a1a2b2065ad6e24a0e5ddd7908c835a1f6d8ef4fa56e?d=identicon)[WebDevStudios](/maintainers/WebDevStudios)

---

Top Contributors

[![gregrickaby](https://avatars.githubusercontent.com/u/200280?v=4)](https://github.com/gregrickaby "gregrickaby (646 commits)")[![coreymcollins](https://avatars.githubusercontent.com/u/954724?v=4)](https://github.com/coreymcollins "coreymcollins (253 commits)")[![obenland](https://avatars.githubusercontent.com/u/1398304?v=4)](https://github.com/obenland "obenland (165 commits)")[![khleomix](https://avatars.githubusercontent.com/u/1948204?v=4)](https://github.com/khleomix "khleomix (164 commits)")[![colorful-tones](https://avatars.githubusercontent.com/u/405912?v=4)](https://github.com/colorful-tones "colorful-tones (106 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (99 commits)")[![jomurgel](https://avatars.githubusercontent.com/u/5230729?v=4)](https://github.com/jomurgel "jomurgel (96 commits)")[![ianstewart](https://avatars.githubusercontent.com/u/545779?v=4)](https://github.com/ianstewart "ianstewart (83 commits)")[![bradp](https://avatars.githubusercontent.com/u/66798?v=4)](https://github.com/bradp "bradp (74 commits)")[![oliverharrison](https://avatars.githubusercontent.com/u/18194487?v=4)](https://github.com/oliverharrison "oliverharrison (55 commits)")[![efuller](https://avatars.githubusercontent.com/u/4174472?v=4)](https://github.com/efuller "efuller (51 commits)")[![batesweb](https://avatars.githubusercontent.com/u/1083785?v=4)](https://github.com/batesweb "batesweb (25 commits)")[![asharirfan](https://avatars.githubusercontent.com/u/8023941?v=4)](https://github.com/asharirfan "asharirfan (25 commits)")[![aubreypwd](https://avatars.githubusercontent.com/u/1753298?v=4)](https://github.com/aubreypwd "aubreypwd (22 commits)")[![kovshenin](https://avatars.githubusercontent.com/u/108344?v=4)](https://github.com/kovshenin "kovshenin (19 commits)")[![jrfoell](https://avatars.githubusercontent.com/u/630830?v=4)](https://github.com/jrfoell "jrfoell (18 commits)")[![bezierer](https://avatars.githubusercontent.com/u/9514619?v=4)](https://github.com/bezierer "bezierer (16 commits)")[![iamtakashi](https://avatars.githubusercontent.com/u/908665?v=4)](https://github.com/iamtakashi "iamtakashi (16 commits)")[![itsamoreh](https://avatars.githubusercontent.com/u/12365909?v=4)](https://github.com/itsamoreh "itsamoreh (14 commits)")[![sixhours](https://avatars.githubusercontent.com/u/2124984?v=4)](https://github.com/sixhours "sixhours (14 commits)")

---

Tags

gutenberghacktoberfestjavascriptphpscssstarter-themetailwindcsswordpresswordpress-scriptswordpress-theme

### Embed Badge

![Health badge](/badges/webdevstudios-wd-s/health.svg)

```
[![Health](https://phpackages.com/badges/webdevstudios-wd-s/health.svg)](https://phpackages.com/packages/webdevstudios-wd-s)
```

###  Alternatives

[elgg/elgg

Elgg is an award-winning social networking engine, delivering the building blocks that enable businesses, schools, universities and associations to create their own fully-featured social networks and applications.

1.7k15.7k5](/packages/elgg-elgg)[pressbooks/pressbooks

Pressbooks is an open source book publishing tool built on a WordPress multisite platform. Pressbooks outputs books in multiple formats, including PDF, EPUB, web, and a variety of XML flavours, using a theming/templating system, driven by CSS.

44643.1k1](/packages/pressbooks-pressbooks)[johnbillion/user-switching

Instant switching between user accounts in WordPress and WooCommerce.

19768.3k2](/packages/johnbillion-user-switching)[rainlab/blog-plugin

Blog plugin for October CMS

17257.7k](/packages/rainlab-blog-plugin)[rainlab/user-plugin

User plugin for October CMS

11954.3k13](/packages/rainlab-user-plugin)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
