{"id":18615631,"url":"https://github.com/hex-digital/bloom","last_synced_at":"2025-11-03T04:30:34.378Z","repository":{"id":38999992,"uuid":"363105308","full_name":"hex-digital/bloom","owner":"hex-digital","description":null,"archived":false,"fork":false,"pushed_at":"2023-01-07T07:08:10.000Z","size":10122,"stargazers_count":0,"open_issues_count":20,"forks_count":0,"subscribers_count":4,"default_branch":"main","last_synced_at":"2024-12-27T03:12:27.501Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"PHP","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/hex-digital.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-04-30T10:24:44.000Z","updated_at":"2021-04-30T12:24:09.000Z","dependencies_parsed_at":"2023-02-06T14:30:43.401Z","dependency_job_id":null,"html_url":"https://github.com/hex-digital/bloom","commit_stats":null,"previous_names":[],"tags_count":21,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hex-digital%2Fbloom","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hex-digital%2Fbloom/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hex-digital%2Fbloom/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hex-digital%2Fbloom/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hex-digital","download_url":"https://codeload.github.com/hex-digital/bloom/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239406497,"owners_count":19633025,"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":[],"created_at":"2024-11-07T03:30:58.314Z","updated_at":"2025-11-03T04:30:34.330Z","avatar_url":"https://github.com/hex-digital.png","language":"PHP","funding_links":["https://www.patreon.com/rootsdev"],"categories":[],"sub_categories":[],"readme":"# Bloom - Hex Digital\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eWordPress starter theme with a modern development workflow\u003c/strong\u003e\n  \u003cbr /\u003e\n  Built with 🌯 at [Hex Digital](https://www.hexdigital.com)\n\u003c/p\u003e\n\n## Supporting\n\n**Bloom** is an open source project and completely free to use.\n\nHowever, we highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using. You'll find our address [in our website footer](https://www.hexdigital.com/). We publish all received postcards on our virtual postcard wall.\n\n**Bloom** wouldn't be possible without the fantastic work by **Roots**, so please consider supporting them with a [sponsorship](https://www.patreon.com/rootsdev).\n\n## About Bloom\n\nBloom is an opinionated, productivity-driven WordPress starter theme with a modern development workflow.\n\nWe recommend using Bloom if you're looking to spend less time building the same functionality for each project.\n\nAny and all features can be disabled if you prefer, so even if you disagree with some of our opinions, it may still be a good fit for you.\n\n## Features\n\n- Environment variables, powered by [env](oscarotero/env) and [dotenv](https://github.com/vlucas/phpdotenv).\n- Improved CSS objects and extra utilities, from [CaptainCSS](https://captaincss.hexdigital.com/).\n- Image Lazy Loading, powered by [Vanilla LazyLoad](https://github.com/verlok/vanilla-lazyload).\n\nNote that some functionality relies on our [functionality plugin, Sprout](https://github.com/hex-digital/sprout). This should be added to your `mu-plugins`.\nIf any functionality is enabled that relies on Sprout, and Sprout is not found, you'll see an error in the WordPress dashboard.\n\nSee [the Sage repository](https://github.com/roots/sage) for more features from the underlying framework.\n\n## Requirements\n\nMake sure all dependencies have been installed before moving on:\n\n- [WordPress](https://wordpress.org/) \u003e= 5.4\n- [PHP](https://secure.php.net/manual/en/install.php) \u003e= 7.3.0 (with [`php-mbstring`](https://secure.php.net/manual/en/book.mbstring.php) enabled)\n- [Composer](https://getcomposer.org/download/)\n- [Node.js](http://nodejs.org/) \u003e= 12.14.0\n- [Yarn](https://yarnpkg.com/en/docs/install)\n\n## Theme installation\n\nClone the repo into the `themes` directory of your WordPress installation.\n\n## Theme structure\n\n```sh\nthemes/your-theme-name/   # → Root of your Sage based theme\n├── app/                  # → Theme PHP\n│   ├── View/             # → View models\n│   ├── Providers/        # → Service providers\n│   ├── admin.php         # → Theme customizer setup\n│   ├── filters.php       # → Theme filters\n│   ├── helpers.php       # → Helper functions\n│   └── setup.php         # → Theme setup\n├── bootstrap/            # → Acorn bootstrap\n│   ├── cache/            # → Acorn cache location (never edit)\n│   └── app.php           # → Acorn application bootloader\n├── config/               # → Config files\n│   ├── app.php           # → Application configuration\n│   ├── assets.php        # → Asset configuration\n│   ├── filesystems.php   # → Filesystems configuration\n│   ├── logging.php       # → Logging configuration\n│   └── view.php          # → View configuration\n├── composer.json         # → Autoloading for `app/` files\n├── composer.lock         # → Composer lock file (never edit)\n├── public/               # → Built theme assets (never edit)\n├── functions.php         # → Theme bootloader\n├── index.php             # → Theme template wrapper\n├── node_modules/         # → Node.js packages (never edit)\n├── package.json          # → Node.js dependencies and scripts\n├── resources/            # → Theme assets and templates\n│   ├── fonts/            # → Theme fonts\n│   ├── images/           # → Theme images\n│   ├── scripts/               # → Theme javascript\n│   ├── styles/              # → Theme stylesheets\n│   └── views/            # → Theme templates\n│       ├── components/   # → Component templates\n│       ├── form/         # → Form templates\n│       ├── layouts/      # → Base templates\n│       └── partials/     # → Partial templates\n├── screenshot.png        # → Theme screenshot for WP admin\n├── storage/              # → Storage location for cache (never edit)\n├── style.css             # → Theme meta information\n├── vendor/               # → Composer packages (never edit)\n└── webpack.mix.js        # → Laravel Mix configuration\n```\n\n## Theme setup\n\nEdit files in `/config` for theme configuration.\n\nEdit `app/setup.php` to enable or disable theme features, setup navigation menus, post thumbnail sizes, and sidebars.\n\n## Theme development\n\n- Run `composer install` from the theme directory to install php dependencies\n- Run `yarn` from the theme directory to install front end dependencies\n- Copy `.env.example` to `.env`, and update  with your local dev URL for browsersync\n\n### Build commands\n\n- `yarn start` — Compile assets when file changes are made, start Browsersync session\n- `yarn hot` — Same as `start` with hot module reloading\n- `yarn build` — Compile and optimize the files in your assets directory\n- `yarn build:production` — Compile assets for production\n\n## Updating Sage framework\n\nThe `upstream` branch tracks Sage 10.\n\nThe easiest way to update this theme is to pull in the latest changes from Sage\ninto the `upstream` branch, then create a PR from `upstream` to `main`.\n\nThis will highlight all Sage changes, as well as any conflicts to solve.\n\n## Documentation\n\nPlease see the [Sage documentation](https://roots.io/sage/docs/) for the underlying theme.\n\nDocumentation for Bloom is in the works.\n\n## Contributing\n\nContributions are welcome from everyone. \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhex-digital%2Fbloom","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhex-digital%2Fbloom","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhex-digital%2Fbloom/lists"}