{"id":21319548,"url":"https://github.com/simplajs/simpla-admin","last_synced_at":"2026-03-07T23:31:51.903Z","repository":{"id":58242892,"uuid":"81295765","full_name":"simplajs/simpla-admin","owner":"simplajs","description":"Beautiful, lightweight admin component for Simpla apps","archived":false,"fork":false,"pushed_at":"2017-12-15T05:46:54.000Z","size":316,"stargazers_count":12,"open_issues_count":7,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2026-02-18T17:37:35.960Z","etag":null,"topics":["admin","content-management","custom-element","simpla","web-components"],"latest_commit_sha":null,"homepage":"https://www.simplajs.org","language":"HTML","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/simplajs.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}},"created_at":"2017-02-08T06:28:42.000Z","updated_at":"2018-03-23T17:14:14.000Z","dependencies_parsed_at":"2022-08-31T00:41:15.024Z","dependency_job_id":null,"html_url":"https://github.com/simplajs/simpla-admin","commit_stats":null,"previous_names":["simplaelements/simpla-admin"],"tags_count":28,"template":false,"template_full_name":null,"purl":"pkg:github/simplajs/simpla-admin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simplajs%2Fsimpla-admin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simplajs%2Fsimpla-admin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simplajs%2Fsimpla-admin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simplajs%2Fsimpla-admin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/simplajs","download_url":"https://codeload.github.com/simplajs/simpla-admin/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simplajs%2Fsimpla-admin/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30237329,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-07T23:24:20.706Z","status":"ssl_error","status_checked_at":"2026-03-07T23:21:10.486Z","response_time":53,"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":["admin","content-management","custom-element","simpla","web-components"],"created_at":"2024-11-21T19:42:46.609Z","updated_at":"2026-03-07T23:31:51.858Z","avatar_url":"https://github.com/simplajs.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Simpla Admin\n[![Build status][travis-badge]][travis-url] ![Size][size-badge] ![Version][bower-badge] [![Published][webcomponents-badge]][webcomponents-url]\n\nSimpla-admin is a lightweight, beautiful admin component for the [Simpla][simpla] content system. It provides everything you need to manage a Simpla app (login prompts, edit mode management, save controls, notifications, keyboard shortcuts) while remaining unobtrusive and minimal.\n\n### Contents\n\n- [Installation and setup](#installation-and-setup)\n- [Hashtracking](#hashtracking)\n- [Login prompts](#login-prompts)\n- [Hotkeys](#hotkeys)\n- [Accidental click protection](#accidental-click-protection)\n- [Notifications](#notifications)\n- [Contributing](#contributing)\n\n### Resources\n\n- [API reference][api]\n- [Demo][demo]\n- [License][license]\n\n## Installation and setup\n\nInstall simpla-admin with Bower (Yarn support coming soon)\n\n```sh\n$ bower i simpla-admin --save\n```\n\n[Setup Simpla][simpla-setup] on your page, then import simpla-admin into your `\u003chead\u003e`. It will automatically attach and load itself as a singleton when Simpla enters edit mode.\n\n```html\n\u003clink rel=\"import\" href=\"/bower_components/simpla-admin/simpla-admin.html\" async\u003e\n```\n\n\n## Hashtracking\n\nSimpla-admin binds `#edit` to Simpla's edit mode. To enter edit mode, add `#edit` to the end of your URL. To exit edit mode, remove `#edit` from the URL.\n\nYou can disable hashtracking with the `hashTracking` property\n\n```js\nwindow.SimplaAdmin = window.SimplaAdmin || {};\nwindow.SimplaAdmin.hashTracking = false;\n```\n\n## Login prompts\n\nIf you're not authenticated when trying to enter edit mode, simpla-admin will prompt you to login with [`\u003csimpla-login\u003e`](https://www.webcomponents.org/element/SimplaElements/simpla-login). Closing the login modal without logging in exits edit mode. \n\nThe user will be prompted for login regardless of whether you enter edit mode via simpla-admin (`#edit`) or programmatically with Simpla (`Simpla.editable(true)`).\n\nYou can disable login prompts with the `loginPrompt` property, and authenticate manually with the `Simpla.login()` method\n\n```js\nwindow.SimplaAdmin = window.SimplaAdmin || {};\nwindow.SimplaAdmin.loginPrompt = false;\n```\n\n## Hotkeys\n\nSimpla-admin binds keyboard shortcuts to several common actions. On Mac the command key is used, on Windows the control key is used.\n\nShortcut           | Description                              \n------------------ | -----------                              \n`cmd`/`ctrl` + `s` | Save                                     \n`cmd`/`ctrl` + `e` | Toggle edit mode (only if authenticated) \n\nYou can disable all hotkeys with the `hotkeys` property\n\n```js\nwindow.SimplaAdmin = window.SimplaAdmin || {};\nwindow.SimplaAdmin.hotkeys = false;\n```\n\n## Accidental click protection\n\nSimpla-admin makes a page non-interactive while it's being edited, so users can edit content inside interactive elements (links, buttons, lightboxes) without accidentally leaving the page. Toggle off edit mode to re-enable clicks, your changes will remain in the local buffer until you either save or reload the page.\n\nYou can disable edit mode protection with the `protectEditing` property\n\n```js\nwindow.SimplaAdmin = window.SimplaAdmin || {};\nwindow.SimplaAdmin.protectEditing = false;\n```\n\n## Notifications\n\nSimpla-admin displays notifications for things like content saves with [`\u003csimpla-notify\u003e`](https://www.webcomponents.org/element/SimplaElements/simpla-notify). You can display your own custom notifications by firing a `simpla-notification` window event with a `text` property\n\n```js\nvar notification = new CustomEvent('simpla-notification', { \n  detail: {\n    text: 'something happened'\n  } \n});\n\nwindow.dispatchEvent(notification);\n```\n  \n## Contributing\n\nIf you find any issues with simpla-admin please report them! If you'd like to see a new feature supported file an issue. We also happily accept PRs. \n\n***\n\nMIT © [Simpla][simpla]\n\n[api]: https://www.webcomponents.org/element/SimplaElements/simpla-admin/page/API.md\n[demo]: https://www.webcomponents.org/element/SimplaElements/simpla-admin/demo/demo/index.html\n[license]: https://github.com/SimplaElements/simpla-admin/blob/master/LICENSE\n\n[simpla]: https://www.simpla.io\n[simpla-setup]: https://www.simpla.io/docs/guides/get-started\n\n[bower-badge]: https://img.shields.io/bower/v/simpla-admin.svg\n[travis-badge]: https://img.shields.io/travis/simplaio/simpla-admin.svg\n[travis-url]: https://travis-ci.org/simplaios/simpla-admin\n[size-badge]: https://badges.herokuapp.com/size/github/simplaio/simpla-admin/master/simpla-admin.html?gzip=true\n[webcomponents-badge]: https://img.shields.io/badge/webcomponents.org-published-blue.svg\n[webcomponents-url]: https://www.webcomponents.org/element/simplaio/simpla-admin\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimplajs%2Fsimpla-admin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsimplajs%2Fsimpla-admin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimplajs%2Fsimpla-admin/lists"}