{"id":13759961,"url":"https://github.com/htmlburger/wpemerge-theme","last_synced_at":"2025-06-19T02:05:20.603Z","repository":{"id":44057482,"uuid":"131894538","full_name":"htmlburger/wpemerge-theme","owner":"htmlburger","description":"An organized, ES6 and SASS powered theme taking advantage of the WP Emerge framework. 🚀","archived":false,"fork":false,"pushed_at":"2022-04-16T18:32:33.000Z","size":1430,"stargazers_count":286,"open_issues_count":1,"forks_count":33,"subscribers_count":18,"default_branch":"master","last_synced_at":"2025-05-10T10:36:17.196Z","etag":null,"topics":["blade","php","starter-theme","wordpress","wp-emerge-theme","wpemerge"],"latest_commit_sha":null,"homepage":"https://wpemerge.com/","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/htmlburger.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-05-02T19:05:24.000Z","updated_at":"2025-04-11T05:36:24.000Z","dependencies_parsed_at":"2022-08-21T10:10:17.254Z","dependency_job_id":null,"html_url":"https://github.com/htmlburger/wpemerge-theme","commit_stats":null,"previous_names":[],"tags_count":16,"template":false,"template_full_name":null,"purl":"pkg:github/htmlburger/wpemerge-theme","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/htmlburger%2Fwpemerge-theme","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/htmlburger%2Fwpemerge-theme/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/htmlburger%2Fwpemerge-theme/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/htmlburger%2Fwpemerge-theme/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/htmlburger","download_url":"https://codeload.github.com/htmlburger/wpemerge-theme/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/htmlburger%2Fwpemerge-theme/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260669571,"owners_count":23044299,"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":["blade","php","starter-theme","wordpress","wp-emerge-theme","wpemerge"],"created_at":"2024-08-03T13:01:01.532Z","updated_at":"2025-06-19T02:05:15.590Z","avatar_url":"https://github.com/htmlburger.png","language":"PHP","readme":"# \u003ca href=\"http://wpemerge.com\"\u003e\u003cimg src=\"https://docs.wpemerge.com/_images/wpemerge-theme-logo-bar.png\" height=\"61\" alt=\"WP Emerge Starter Theme Logo\" aria-label='WPEmerge.com' /\u003e\u003c/a\u003e\n\n[![Packagist](https://img.shields.io/packagist/vpre/htmlburger/wpemerge-theme.svg?style=flat-square\u0026colorB=0366d6)](https://packagist.org/packages/htmlburger/wpemerge-theme) [![Build](https://img.shields.io/github/workflow/status/htmlburger/wpemerge-theme/Tests?style=flat-square)](https://github.com/htmlburger/wpemerge-theme/actions/workflows/test.yml) [![Gitter](https://img.shields.io/gitter/room/nwjs/nw.js.svg?style=flat-square\u0026colorB=7d07d1)](https://gitter.im/wpemerge/Lobby)\n\n\nA modern WordPress starter theme which uses the [WP Emerge](https://github.com/htmlburger/wpemerge) framework.\n\n_This is the WP Emerge Starter Theme project - for the WP Emerge framework please check out https://github.com/htmlburger/wpemerge._\n\n## Summary\n\n- [Documentation](#documentation)\n- [Development Team](#development-team)\n- [Comparison Table](#comparison-table)\n- [Features](#features)\n- [Non-goals](#non-goals)\n- [Requirements](#requirements)\n- [Directory structure](#directory-structure)\n- [Contributing](#contributing)\n\n## Documentation\n\n[http://docs.wpemerge.com/#/starter/theme/overview](http://docs.wpemerge.com/#/starter/theme/overview)\n\n[http://docs.wpemerge.com/#/starter/theme/quickstart](http://docs.wpemerge.com/#/starter/theme/quickstart)\n\n## Development Team\n\nBrought to you by [Atanas Angelov](https://atanas.dev/) and the lovely folks at [htmlBurger](http://htmlburger.com).\n\n## Comparison Table\n\n|                                | WP Emerge Theme  | Sage           | Timber   |\n|--------------------------------|------------------|----------------|----------|\n| View Engine                    | PHP, Blade, Twig, any | PHP, Blade     | Twig     |\n| Routing                        | ✔                | ✖              | ✔        |\n| WP Admin Routing | ✔ | ✖ | ✖ |\n| WP AJAX Routing | ✔ | ✖ | ✖ |\n| MVC                            | ✖✔✔              | ✖✔✖¹           | ✖✔✖      |\n| Middleware                     | ✔                | ✖              | ✖        |\n| View Composers                 | ✔                | ✔/✖²           | ✖        |\n| Service Container              | ✔                | ✔              | ✖        |\n| Stylesheets                    | SASS + PostCSS   | SASS + PostCSS | N/A³     |\n| JavaScript                     | ES6              | ES6            | N/A³     |\n| Front end, Admin, Editor and Login Bundles | ✔✔✔✔            | ✔✖✖✖              | N/A³     |\n| Automatic Sprite Generation    | ✔                | ✖              | N/A³     |\n| Automatic Cache Busting        | ✔                | ✖              | ✖        |\n| WPCS Linting                   | ✔                | ✖              | ✖        |\n| [Advanced Error Reporting](https://docs.wpemerge.com/#/framework/routing/error-handling) | ✔ | ✖ | ✖ |\n| WP Unit Tests for your classes | ✔                | ✖              | ✖        |\n\n_¹ Sage's Controller is more of a View Composer than a Controller._\n\n_² Sage's Controller provides similar functionality but is limited to 1 composer (controller) per view and vice versa._\n\n_³ Timber does not provide a front-end build process so you can implement whatever you prefer._\n\n_Email any factual inaccuracies to [hi@atanas.dev](mailto:hi@atanas.dev) so they can be corrected._\n\n## Features\n- All features from [WP Emerge](https://docs.wpemerge.com/#/framework/overview):\n  - Named routes with custom URLs and query filters\n  - Controllers\n  - Middleware\n  - PSR-7 Responses\n  - View Composers\n  - Service Container\n  - Service Providers\n  - PHP view layouts (a.k.a. automatic wrapping)\n  - Support for PHP, [Blade 5.4](https://laravel.com/docs/5.4/blade) and/or [Twig 2](https://twig.symfony.com/doc/2.x/api.html) for views\n- Gutenberg support.\n- [SASS](https://sass-lang.com/) + [PostCSS](https://github.com/postcss/postcss) for stylesheets. Separate bundles are created for **front-end**, **administration**, **Gutenberg** and **login** pages and custom bundles can be added easily.\n- ES6 for JavaScript. Separate bundles are created for **front-end**, **administration**, **Gutenberg** and **login** pages and custom bundles can be added easily.\n- Pure [Webpack](https://webpack.js.org/) to transpile and bundle assets, create sprites, optimize images etc.\n- [Hot Module Replacement](https://webpack.js.org/concepts/hot-module-replacement/) for synchronized browser development.\n- Autoloading for all classes in your `MyApp\\` namespace.\n- Automatic, fool-proof cache busting for all assets, including ones referenced in styles.\n- WPCS, JavaScript and SASS linting and fixing using a single yarn command.\n- Single-command optional CSS package installation:\n    - Normalize.css\n    - Boostrap 4\n    - Bulma\n    - Foundation\n    - Tachyons\n    - Tailwind CSS\n    - Spectre.css\n    - FontAwesome\n- WP Unit Test scaffolding for your own classes.\n\n## Non-goals\n\n- Taking over the WordPress main query.\n\n  WP Emerge does __not__ take over the main query - it actively works with it.\n- Taking over WordPress routing.\n\n  WP Emerge does __not__ take over WordPress' routing - it actively works with it. The only exception to this are hardcoded URLs explicitly added by a user.\n- Reinventing WordPress APIs using object-oriented interfaces.\n\n  WP Emerge does not provide alternative APIs for registering post types, taxonomies or the like for little added benefit. Instead, it provides logical and handy places for developers to use core APIs.\n- Using a third party engine by default.\n\n  WP Emerge uses PHP by default in the same way WordPress does but with added features. Using a third party engine is entirely optional and requires installing an extension.\n- Include most of Laravel or another framework.\n\n  WP Emerge is lean and tuned for WordPress. While inspired by Laravel, it does not come with any `illuminate/*` packages. There are only 2 third party production dependencies:\n  - `pimple/pimple` - The single-file PHP service container.\n  - `guzzlehttp/psr7` - A PSR-7 Request and ServerRequest implementation.\n\n## Requirements\n\n- [PHP](http://php.net/) \u003e= 5.5\n- [WordPress](https://wordpress.org/) \u003e= 4.7\n- [Composer](https://getcomposer.org/)\n- [Node.js](https://nodejs.org/en/) \u003e= 12\n- [Yarn](https://yarnpkg.com/en/) or NPM\n\n## Directory structure\n\n```\nwp-content/themes/your-theme\n├── app/\n│   ├── helpers/              # Helper files, add your own here as well.\n│   ├── routes/               # Register your WP Emerge routes.\n│   │   ├── admin.php\n│   │   ├── ajax.php\n│   │   └── web.php\n│   ├── src/                  # PSR-4 autoloaded classes.\n│   │   ├── Controllers/      # Controller classes for WP Emerge routes.\n│   │   ├── Routing/          # Register your custom routing conditions etc.\n│   │   ├── View/             # Register your view composers, globals etc.\n│   │   ├── WordPress/        # Register post types, taxonomies, menus etc.\n│   │   └── ...\n│   ├── config.php            # WP Emerge configuration.\n│   ├── helpers.php           # Require your helper files here.\n│   ├── hooks.php             # Register your actions and filters here.\n│   └── version.php           # WP Emerge version handling.\n├── dist/                     # Bundles, optimized images etc.\n├── languages/                # Language files.\n├── resources/\n│   ├── build/                # Build process configuration.\n│   ├── fonts/\n│   ├── images/\n│   ├── scripts/\n│   │   ├── admin/            # Administration scripts.\n│   │   ├── editor/           # Gutenberg editor scripts.\n│   │   ├── login/            # Login scripts.\n│   │   └── frontend/         # Front-end scripts.\n│   ├── styles/\n│   │   ├── admin/            # Administration styles.\n│   │   ├── editor/           # Gutenberg editor styles.\n│   │   ├── login/            # Login styles.\n│   │   ├── frontend/         # Front-end styles.\n│   │   └── shared/           # Shared styles.\n│   └── vendor/               # Any third-party, non-npm assets.\n├── vendor/                   # Composer packages.\n├── views/\n│   ├── layouts/\n│   └── partials/\n├── views-alternatives/       # Views for other engines like Blade.\n├── functions.php             # Bootstrap theme.\n├── screenshot.png            # Theme screenshot.\n├── style.css                 # Theme stylesheet.\n├── wpemerge                  # WP Emerge CLI shortcut.\n└── ...\n```\n\n### Notable directories\n\n#### `app/helpers/`\n\nAdd PHP helper files here. Helper files should include __function definitions only__. See below for information on where to put actions, filters, classes etc.\n\n#### `app/src/`\n\nAdd PHP class files here. All clases in the `MyApp\\` namespace are autoloaded in accordance with [PSR-4](http://www.php-fig.org/psr/psr-4/).\n\n#### `resources/images/`\n\nAdd images for styling here. Optimized copies will be placed in `dist/images/` when running the build process.\n\n#### `resources/styles/frontend/`\n\nAdd .css and .scss files to add them to the front-end bundle. Don't forget to `@import` them in `index.scss`.\n\n#### `resources/styles/[admin,editor,login]/`\n\nThese directories are for the admin, editor and login bundles, respectively. They work identically to the main `resources/styles/frontend/` directory.\n\n#### `resources/scripts/frontend/`\n\nAdd JavaScript files here to add them to the frontend bundle. The entry point is `index.js`.\n\n#### `resources/scripts/[admin,editor,login]/`\n\nThese directories are for the admin, editor and login bundles, respectively. They work identically to the main `resources/scripts/frontend/` directory.\n\n#### `views/`\n\nWhile views that follow the WordPress template hierarchy should go in the theme root directory (e.g. `index.php`, `searchform.php`, `archive-post.php` etc.), others should go in the following directories:\n1. `views/layouts/` - Layouts that other views extend.\n2. `views/partials/` - Small snippets that are meant to be reused throughout other views.\n3. `views/` - Named [custom post templates](https://developer.wordpress.org/themes/template-files-section/page-template-files/#creating-custom-page-templates-for-global-use) or views that don't fit anywhere else.\n\nAvoid adding any PHP logic in any of these views, unless it pertains to layouting. Business logic should go into:\n- Helper files (`app/helpers/*.php`)\n- Service classes\n- [WP Emerge Controllers](https://docs.wpemerge.com/#/framework/routing/controllers)\n\n## Contributing\n\nWP Emerge Starter Theme is completely open source and we encourage everybody to participate by:\n\n- Reviewing `.github/CONTRIBUTING.md`.\n- ⭐ the project on GitHub \\([https://github.com/htmlburger/wpemerge-theme](https://github.com/htmlburger/wpemerge-theme)\\)\n- Posting bug reports \\([https://github.com/htmlburger/wpemerge-theme/issues](https://github.com/htmlburger/wpemerge-theme/issues)\\)\n- (Emailing security issues to [hi@atanas.dev](mailto:hi@atanas.dev) instead)\n- Posting feature suggestions \\([https://github.com/htmlburger/wpemerge-theme/issues](https://github.com/htmlburger/wpemerge-theme/issues)\\)\n- Posting and/or answering questions \\([https://github.com/htmlburger/wpemerge-theme/issues](https://github.com/htmlburger/wpemerge-theme/issues)\\)\n- Submitting pull requests \\([https://github.com/htmlburger/wpemerge-theme/pulls](https://github.com/htmlburger/wpemerge-theme/pulls)\\)\n- Sharing your excitement about WP Emerge with your community\n","funding_links":[],"categories":["PHP","WordPress Starter Themes"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhtmlburger%2Fwpemerge-theme","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhtmlburger%2Fwpemerge-theme","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhtmlburger%2Fwpemerge-theme/lists"}