Installation
Two ways to install; both end with the same two requirements: the theme folder must be
named blogtail-general, and the WindPress plugin must be active.
Requirements
| Requirement | Value |
|---|---|
| WordPress | 6.0 or newer (header declares tested up to 7.1) |
| PHP | 7.4 or newer |
| Plugin | WindPress (Tailwind CSS v4 mode) — required, the theme ships no visual CSS |
| Access | the repository is private: tbskit/blogtail-general |
| Build tools | none |
Method 1 — ZIP upload (no shell access needed)
Download the ZIP
Releases → v1.0.4 → asset blogtail-general-1.0.4.zip (published 26 Sep 2026).
The repository is private, so you need access to tbskit/blogtail-general to download it.
Upload it in WordPress
Appearance → Themes → Add New → Upload Theme → choose the ZIP → Install Now.
WordPress unpacks it into wp-content/themes/blogtail-general.
Activate
Appearance → Themes → Blogtail General → Activate.
Method 2 — Copy/clone into the themes folder
Go to the themes directory
cd <wp-root>/wp-content/themes/Get the theme (folder name must stay blogtail-general)
# private repo: authenticate first (gh auth login) or use a personal access token
git clone https://github.com/tbskit/blogtail-general.git blogtail-general
ls blogtail-general/style.css # sanity checkActivate
Appearance → Themes → Blogtail General → Activate.
blogtail-general.Install and activate WindPress
Install the plugin
Plugins → Add New → search for WindPress → Install Now → Activate.
Switch it to Tailwind CSS v4 mode
Open the WindPress settings and enable Tailwind CSS v4. The reference installation runs WindPress 3.2.90.
Reload the front end
The theme’s Tailwind utility classes are collected from the markup and compiled by WindPress — after activation the site should be styled.
Activate the theme (WP-CLI is optional)
Appearance → Themes → Blogtail General → Activate.
The WordPress container on this server does not ship WP-CLI (verified 27 Sep 2026), so
activation is done in wp-admin. If you install WP-CLI yourself, the equivalent command is:
wp theme activate blogtail-generalFile permissions (this server)
On 192.168.1.2 the WordPress document root is mounted from
/home/www/project/wordpress/web/web, and the web server runs as uid/gid 82
(www-data inside the Alpine container). Theme files must be owned by that user, otherwise
WordPress cannot update or delete them from the admin:
chown -R 82:82 /home/www/project/wordpress/web/web/wp-content/themes/blogtail-generalVerify the installation
| Check | Expected |
|---|---|
| Front page | Hero plus the “Latest Articles” card grid |
| Styling | Layout/spacing/typography look designed, not plain |
| If it looks plain | WindPress inactive, or its Tailwind CSS v4 mode is off, or the CSS has not been compiled yet |
| After editing a file | Hard reload — asset versions use each file’s mtime, so no cache bump is needed |
Reference installation (this server)
| Item | Value |
|---|---|
| Theme version | 1.0.4 |
| Theme path | /home/www/project/wordpress/web/web/wp-content/themes/blogtail-general |
| Plugin | WindPress 3.2.90 at .../wp-content/plugins/windpress |
| Other themes present | twentytwentythree, twentytwentyfour, twentytwentyfive |
Rollback / uninstall
- Appearance → Themes → activate another theme (e.g. Twenty Twenty-Five).
- Then delete the theme: Appearance → Themes → Blogtail General → Theme Details → Delete, or remove the folder. Posts, pages and settings in the database are untouched.