{"id":30033530,"url":"https://github.com/tenseg/barnacle","last_synced_at":"2026-01-20T16:44:37.052Z","repository":{"id":307372650,"uuid":"960607355","full_name":"tenseg/barnacle","owner":"tenseg","description":"An extensible toolbar for Statamic","archived":false,"fork":false,"pushed_at":"2026-01-13T04:30:07.000Z","size":112,"stargazers_count":0,"open_issues_count":3,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-01-13T07:49:05.728Z","etag":null,"topics":["statamic","statamic-addon"],"latest_commit_sha":null,"homepage":"","language":"Antlers","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/tenseg.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-04-04T18:18:32.000Z","updated_at":"2026-01-13T04:25:39.000Z","dependencies_parsed_at":"2025-07-31T00:11:19.449Z","dependency_job_id":"8ddba871-f31d-4abc-a6c7-52c5cafcdda2","html_url":"https://github.com/tenseg/barnacle","commit_stats":null,"previous_names":["tenseg/barnacle"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/tenseg/barnacle","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tenseg%2Fbarnacle","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tenseg%2Fbarnacle/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tenseg%2Fbarnacle/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tenseg%2Fbarnacle/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tenseg","download_url":"https://codeload.github.com/tenseg/barnacle/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tenseg%2Fbarnacle/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28477404,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-16T03:13:13.607Z","status":"ssl_error","status_checked_at":"2026-01-16T03:11:47.863Z","response_time":107,"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":["statamic","statamic-addon"],"created_at":"2025-08-06T22:45:24.407Z","updated_at":"2026-01-16T05:47:07.504Z","avatar_url":"https://github.com/tenseg.png","language":"Antlers","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Barnacle\n\nBarnacle is a Statamic addon that creates and extensible toolbar on the front end of your site. Barnacle builds a toolbar using regular Statamic templates/views, which is super flexible. Barnacle is primarily intended as a developer tool, though it can be helpful for site editors and authors as well.\n\n## Features\n\n- Create new components with regular templates\n- Customize which components are exposed to users by role\n- Allow users to customize which components they see\n\n## Installation\n\nBarnacle can be installed via Composer:\n\n```sh\ncomposer require tenseg/barnacle\n```\n\nThen add the `{{ barnacle }}` tag to your Antlers layout just before you closing `\u003c/body\u003e` tag.\n\nBarnacle can direct you to the source code for entries and templates if you add an entry to your `.env` file letting it know what file scheme to use to open files from your web browser. For example, add the following to `.env` to facilitate editing source files with VS Code on macOS:\n\n```sh\nBARNACLE_FILE_SCHEME=vscode://file\n```\n\n## Use\n\nBarnacle attaches a toolbar menu to the upper right corner of your website. You will only see this menu if one of the following is true:\n\n1. Your site is in debug mode (you have set `APP_DEBUG=true` in your `.env` file, for example);\n2. You are logged in to your site;\n3. You have logged in to your site in the past week on the same browser.\n\nThat third option is facilitated by a cookie Barnacle leaves in your browser when you log in. This option can be disabled in role permissions or by setting the `BARNACLE_COOKIE=` to nothing in your `.env` file. If you want to customize the name of the cookie Barnacle uses for this purpose, just put a value into the `.env` file such as `BARNACLE_COOKIE=mysillycookiename`. \n\nYou can also choose to have Barnacle always appear by setting `BARNACLE_ALWAYS=true` in your `.env` file.\n\nEach user can set their own preferences in the Statamic control panel to hide Barnacle components they don't wish to see. Users can also click on the \"pin\" icon to hide Barnacle when it is distracting. Hovering over the space where Barnacle usually appears will make it visible even when hidden.\n\n## Customization\n\nIf you wish to create your own custom components, then first publish Barnacle's templates:\n\n```sh\nphp artisan vendor:publish --tag=barnacle-templates\n```\n\nThis will put the default templates into the `resources/views/vendor/barnacle` directory of your Statamic project.\n\nCustom components are simply template files, like other Statamic views. Given the power of Antlers, which can even include PHP code, the potential for custom components is really endless. See the [example.antlers.html](resources/views/components/example.antlers.html) component for an extremly minimal example, and the [new.antlers.html](resources/views/components/new.antlers.html) component for a much more involved example.\n\nOnce you have defined a new component, you can tell Barnacle to include it by adding a JSON array of custom components to your `.env` file. For example, you would include a component in the template `example.antlers.html` with the following in `.env`:\n\n```sh\nBARNACLE_COMPONENTS='{\"example\":\"Example Component\"}'\n```\n\nThe key matches the template, and the value will be used to describe the component in Statamic permissions and preferences.\n\nYou can also publish Barnacle's configuration if you wish:\n\n```sh\nphp artisan vendor:publish --tag=barnacle-config\n```\nChanges made to the `config/barnacle.php` file will be propagated by git to other instances of the site, while those in the `.env` file typically only apply to that single instance.\n\n## Credits\n\nThis addon was inspired by both the [Statamic Toolbar](https://statamic.com/addons/heidkaemper/toolbar) addon and the [Admin Bar](https://statamic.com/addons/el-schneider/admin-bar) addon. Both of those are wonderful and worthy of you consideration before you decide to adopt Barnacle. They each can do things that Barnacle does not do.\n\nThe icons are from [Iconoir at Iconify](https://icon-sets.iconify.design/iconoir/) by Luca Burgio and made available with an MIT license.\n\nBarnacle is made available under an open source [MIT License](LICENSE.txt) by [Tenseg LLC](https://www.tenseg.net).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftenseg%2Fbarnacle","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftenseg%2Fbarnacle","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftenseg%2Fbarnacle/lists"}