{"id":19097965,"url":"https://github.com/aggrosoft/wave-webpack-build","last_synced_at":"2026-02-16T11:35:18.979Z","repository":{"id":69562687,"uuid":"321939698","full_name":"aggrosoft/wave-webpack-build","owner":"aggrosoft","description":"Build Oxid eShop Wave theme using webpack","archived":false,"fork":false,"pushed_at":"2022-04-11T08:59:38.000Z","size":1258,"stargazers_count":1,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-06T16:35:44.957Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aggrosoft.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-12-16T09:58:18.000Z","updated_at":"2023-08-10T17:45:23.000Z","dependencies_parsed_at":"2023-09-15T17:30:09.273Z","dependency_job_id":null,"html_url":"https://github.com/aggrosoft/wave-webpack-build","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/aggrosoft/wave-webpack-build","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aggrosoft%2Fwave-webpack-build","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aggrosoft%2Fwave-webpack-build/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aggrosoft%2Fwave-webpack-build/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aggrosoft%2Fwave-webpack-build/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aggrosoft","download_url":"https://codeload.github.com/aggrosoft/wave-webpack-build/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aggrosoft%2Fwave-webpack-build/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29506768,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-16T09:05:14.864Z","status":"ssl_error","status_checked_at":"2026-02-16T08:55:59.364Z","response_time":115,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":[],"created_at":"2024-11-09T03:43:40.340Z","updated_at":"2026-02-16T11:35:18.959Z","avatar_url":"https://github.com/aggrosoft.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# wave-webpack-build\nBuild Oxid eShop Wave theme using webpack encore\n\n## Installation\n\nYou will need [composer](https://www.get-composer.org) and [nodejs](https://www.nodejs.org) and [yarn](https://yarnpkg.com/getting-started/install) installed to use this.\nRun the following commands to get started.\n\n`git clone https://github.com/aggrosoft/wave-webpack-build.git`\n\n`yarn install`\n\n`composer install`\n\n`yarn run wave:init`\n\nTo be able to include module related css or anything else from your shop install we recommend symlinking DEPLOY_PATH with\nyour shop source folder. This will also auto copy everything on builds to the shop.\n\n`ln -s [SHOP_SOURCE] [DEPLOY_PATH]`\n\nFor this kind of setup we recommend having the webpack builder in a subfolder where your oxid composer.json lies.\n\n* install-folder\n* * source\n* * vendor\n* * composer.json\n* * ...\n* * **webpack** (create folder and clone here)\n\nYou can then symlink your shop as easy as\n\n`cd webpack \u0026\u0026 ln -s ../source/ public`\n\n## Usage\n\nCopy `.env.dist` to `.env` and change parameters accordingly.\n\nClone `assets/child/example/` and adjust to your template name. There is also an more sophisticated template `assets/child/glide`\nwhich you can use as a starter.\n\nModify everything in `assets/child/[yourtheme]` folder to your needs. You must adjust `package.json` and `theme.php` with the\ncorrect template id. Then run the following command to build the assets in `public` folder\n\n`yarn run build:prod`\n\nWhile developing you can auto build / deploy with\n\n`yarn run watch`\n\nIf you only need to watch template changes use \n\n`yarn run watch:template`\n\n## CSS Purging\n\nFor CSS purging to work correctly `assets/child/[yourtheme]/tpl` should contain a copy of your template files.\nTo enable this feature set `USE_PURGECSS=1` in .env file, this is still experimental as dynamic contents (CMS etc.)\nwill not be picked up.\n\n## Webp Generator\n\nThe module can convert all jpg and png images in your out folder to webp. Run the `yarn generate:webp` command.\n\nAfter that add the following htaccess rules:\n```\nRewriteCond %{HTTP_ACCEPT} image/webp\nRewriteCond %{REQUEST_FILENAME} (.*)\\.(jpg|png)$\nRewriteCond %1\\.webp -f\nRewriteRule ^(.*)\\.(jpg|png)$ $1.webp [L,T=image/webp,R]\n```\n## Deployment\n\nContents of `public` folder need to be deployed to your `source` folder. \n\nAlternatively you can set AUTO_DEPLOY in .env  and enter Ftp credentials to deploy to. Run \n\n`yarn run deploy` or `yarn run build-deploy`\n\nto build and/or deploy in single command\n\n\n## Dependencies\n\nYou need to have [oxid-webpack-theme-loader](https://github.com/aggrosoft/oxid-webpack-theme-loader) module installed and enabled to \nuse the themes correctly.\n\n## But why?\n\nWave theme is compiled using Grunt currently, it lacks effective tree shaking and css purging. This leads to badly\noptimized assets and slower loading times. Using this webpack build will remove unneeded javascript and css from the\ntemplate.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faggrosoft%2Fwave-webpack-build","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faggrosoft%2Fwave-webpack-build","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faggrosoft%2Fwave-webpack-build/lists"}