{"id":22337303,"url":"https://github.com/handmadeweb/buildamic","last_synced_at":"2025-07-29T22:32:51.120Z","repository":{"id":40269603,"uuid":"368690134","full_name":"HandmadeWeb/buildamic","owner":"HandmadeWeb","description":"Buildamic is a Pagebuilder addon for Statamic 3","archived":false,"fork":false,"pushed_at":"2023-11-10T02:09:32.000Z","size":30372,"stargazers_count":12,"open_issues_count":8,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-12-01T13:35:51.468Z","etag":null,"topics":["laravel","page-builder","pagebuilder","statamic","statamic-3","statamic-addon","statamic-v3"],"latest_commit_sha":null,"homepage":"","language":"Vue","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/HandmadeWeb.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2021-05-18T23:21:44.000Z","updated_at":"2024-05-04T18:01:45.000Z","dependencies_parsed_at":"2023-11-09T10:34:28.774Z","dependency_job_id":"59c49aed-6202-4147-9e93-b0a4623abd1c","html_url":"https://github.com/HandmadeWeb/buildamic","commit_stats":{"total_commits":397,"total_committers":8,"mean_commits":49.625,"dds":0.5717884130982368,"last_synced_commit":"ef9825b01bb353e3a0406b38942a54fe71d1bcd0"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HandmadeWeb%2Fbuildamic","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HandmadeWeb%2Fbuildamic/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HandmadeWeb%2Fbuildamic/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HandmadeWeb%2Fbuildamic/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/HandmadeWeb","download_url":"https://codeload.github.com/HandmadeWeb/buildamic/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":228054463,"owners_count":17862129,"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":["laravel","page-builder","pagebuilder","statamic","statamic-3","statamic-addon","statamic-v3"],"created_at":"2024-12-04T06:09:29.992Z","updated_at":"2024-12-04T06:09:30.704Z","avatar_url":"https://github.com/HandmadeWeb.png","language":"Vue","readme":"[![Latest Version on Packagist](https://img.shields.io/packagist/v/handmadeweb/buildamic.svg?style=flat-square)](https://packagist.org/packages/handmadeweb/buildamic)\n[![Total Downloads](https://img.shields.io/packagist/dt/handmadeweb/buildamic.svg?style=flat-square)](https://packagist.org/packages/handmadeweb/buildamic)\n[![MIT Licensed](https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square)](LICENSE.md)\n[![Run Tests](https://github.com/handmadeweb/buildamic/actions/workflows/tests.yml/badge.svg)](https://github.com/handmadeweb/buildamic/actions/workflows/tests.yml)\n\nBuildamic is a WIP \"pagebuilder\" for Statamic 3, It is currently in heavy development and likely to have breaking changes with frequency, as such is not considered ready to be used in production.\n\n## THIS IS A BETA\nPlease be aware that it is not recommended to use this in production just yet.\n\n## Requirements\n* PHP 8.0 or higher\n* Statamic 3.2 or higher\n* Laravel 8.0 or higher\n\n## Installation\n\nYou can install the package via composer:\n\n```bash\ncomposer require handmadeweb/buildamic\n```\n\n## Usage\n\n### Backend\n#### Adding to a blueprint\n\nAdd the field to your blueprint, you may then choose what fields or sets will be available for Buildamic to use.\n\n#### Field/Fieldset/Set Display names\nBuildamic will display the \"label\" for the \"field\" from the first available.\n* Admin Label (Found in the options area of the \"field\")\n* Display (As configured on the blueprint)\n* Handle (As configured on the blueprint)\n\n### Frontend\n#### Grid\nBuildamic comes with a grid starting point (which expects that you are using TailWind), If you aren't going to be writing your own grid, then you should include Buildamic's grid style in your header via the provided helpers for Antlers: `{{ buildamicStyles }}`, Blade: `@buildamicStyles` or PHP: `echo BuildamicHelper()-\u003estyles();`\n\n#### Outputting\nOutputting on the frontend is quite simple, you just use the handle that was given to the field when you configure it in your blueprint.\nAnd reference the below two examples on how to render the output in Antlers or Blade.\n\nStatamic automatically casts the handle to an instance of \\Statamic\\Fields\\Value and will automatically render via the __toString methods.\n\nBy default the handle will be \"buildamic\"\n\n#### Antlers output\n```php\n// The easy way\n{{ buildamic }}\n```\n\n#### Blade output\nIf you are using Blade then We advise using \"Our perferred way\" listed below, which is slightly faster and will show a more complete picture should you choose to run a code profiler (Example: [blackfire.io](https://www.blackfire.io/))\n\n```php\n// The easy way\n{!! $buildamic !!}\n\n// Our perferred way.\n{!! $buildamic-\u003evalue()-\u003erender() !!}\n```\n\n#### View Engines \u0026 View Overrides\nCurrently Buildamic only comes with view files written in Blade.\nBuildamic will still work if your front end uses Antlers, it just means that when Buildamic loops and renders fields, Blade will be used to do so.\n\nShould you need to override a given view (or create new ones) you can do so by creating the views at `resources/views/vendor/buildamic`\n\n#### Field view order\nWhen Buildamic tries to render a field, it will use the first available file, checked in the below order.\n\n* field type: markdown\n* field handle: hero-blurb\n* loaded file: fields/markdown-hero-blurb.blade.php\n\nThen\n\n* field type: markdown\n* loaded file: fields/markdown.blade.php\n\nThen\n\n* catch all\n* loaded file: default-field.blade.php\n\nIn the event that a suitable view could not be located, rather than erroring out or logging an exception, something like the below will instead appear as a html comment.\n\n```html\n\u003c!-- Field could not be rendered, View not found --\u003e\n\u003c!-- Type: bard --\u003e\n\u003c!-- Handle: heading --\u003e\n```\n\n#### Fieldset view order\nWhen Buildamic tries to render a fieldset, it will first try to find a view that matches the handle of the fieldset.\n* handle: blurb\n* loaded file: fieldsets/blurb.blade.php\n\nIf no suitable view was found, then Buildamic will loop through each field within the fieldset and will treat them as separate fields, in which case the fields view order will apply.\n\n#### Set view order\nWhen Buildamic tries to render a set, it will first try to find a view that matches the handle of the set.\n\n* handle: blurb\n* loaded file: sets/blurb.blade.php\n\nIf no suitable view was found, then Buildamic will loop through each field within the set and will treat them as separate fields, in which case the fields view order will apply.\n\n## Changelog\n\nPlease see [CHANGELOG](https://github.com/handmadeweb/buildamic/blob/main/CHANGELOG.md) for more information what has changed recently.\n\n## Contributing\n\nPlease see [CONTRIBUTING](https://github.com/handmadeweb/buildamic/blob/main/CONTRIBUTING.md) for details.\n\n## Credits\n\n- [Aaron Curle](https://github.com/aaroncurlehmw)\n- [John Pieters](https://github.com/sliver37)\n- [Michael Rook](https://github.com/michaelr0)\n- [Handmade Web \u0026 Design](https://github.com/handmadeweb) and [All Contributors](https://github.com/handmadeweb/buildamic/graphs/contributors)\n\n## License\n\nThe MIT License (MIT). Please see [License File](https://github.com/handmadeweb/buildamic/blob/main/LICENSE.md) for more information.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhandmadeweb%2Fbuildamic","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhandmadeweb%2Fbuildamic","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhandmadeweb%2Fbuildamic/lists"}