{"id":13455616,"url":"https://github.com/api-platform/admin","last_synced_at":"2025-05-14T09:11:43.286Z","repository":{"id":2669129,"uuid":"47120306","full_name":"api-platform/admin","owner":"api-platform","description":"A beautiful and fully-featured administration interface builder for hypermedia APIs","archived":false,"fork":false,"pushed_at":"2025-04-11T07:22:58.000Z","size":8096,"stargazers_count":490,"open_issues_count":69,"forks_count":134,"subscribers_count":31,"default_branch":"main","last_synced_at":"2025-05-12T22:08:43.919Z","etag":null,"topics":["admin","api-platform","hacktoberfest","hydra","hypermedia","hypermedia-client","json-ld","react","rest","rest-api"],"latest_commit_sha":null,"homepage":"https://api-platform.com/docs/admin/","language":"TypeScript","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/api-platform.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","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,"zenodo":null},"funding":{"github":"api-platform","open_collective":"api-platform","tidelift":"packagist/api-platform/core"}},"created_at":"2015-11-30T13:29:22.000Z","updated_at":"2025-04-11T07:22:55.000Z","dependencies_parsed_at":"2024-03-27T15:41:48.856Z","dependency_job_id":"543a331e-84d7-48f6-8f02-496d94be474f","html_url":"https://github.com/api-platform/admin","commit_stats":{"total_commits":435,"total_committers":63,"mean_commits":6.904761904761905,"dds":0.6160919540229886,"last_synced_commit":"33e47fadd7e8e0b24409e38dbaddd66474176bf3"},"previous_names":[],"tags_count":101,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/api-platform%2Fadmin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/api-platform%2Fadmin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/api-platform%2Fadmin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/api-platform%2Fadmin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/api-platform","download_url":"https://codeload.github.com/api-platform/admin/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254110374,"owners_count":22016391,"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":["admin","api-platform","hacktoberfest","hydra","hypermedia","hypermedia-client","json-ld","react","rest","rest-api"],"created_at":"2024-07-31T08:01:08.153Z","updated_at":"2025-05-14T09:11:43.254Z","avatar_url":"https://github.com/api-platform.png","language":"TypeScript","readme":"# API Platform Admin\n\n[![GitHub Actions](https://github.com/api-platform/admin/workflows/CI/badge.svg?branch=main)](https://github.com/api-platform/admin/actions?query=workflow%3ACI+branch%3Amain)\n[![npm version](https://badge.fury.io/js/%40api-platform%2Fadmin.svg)](https://badge.fury.io/js/%40api-platform%2Fadmin)\n\nAPI Platform Admin is a tool to automatically create a beautiful (Material Design) and fully-featured administration interface\nfor any API supporting [the Hydra Core Vocabulary](http://www.hydra-cg.com/) or exposing an [OpenAPI documentation](https://www.openapis.org/),\nincluding but not limited to all APIs created using [the API Platform framework](https://api-platform.com).\n\n![Demo of API Platform Admin in action](https://api-platform.com/97cd2738071d63989db0bbcb6ba85a25/admin-demo.gif)\n\nThe generated administration is a 100% standalone Single-Page-Application with no coupling to the server part, according\nto the API-first paradigm.\n\nAPI Platform Admin parses Hydra or OpenAPI documentations, then uses the awesome [React-admin](https://marmelab.com/react-admin/)\nlibrary (and [React](https://facebook.github.io/react/)) to expose a nice, responsive, management interface (Create-Retrieve-Update-Delete)\nfor all available resources.\n\nYou can also customize all screens by using React-admin components and even raw JavaScript/React code.\n\n## Demo\n\n[Click here](https://demo.api-platform.com/admin) to test API Platform Admin in live.\n\nThe source code of the demo is available [in this repository](https://github.com/api-platform/demo).\n\n## Installation\n\n    yarn add @api-platform/admin\n\n## Usage\n\n```javascript\nimport React from 'react';\nimport ReactDOM from 'react-dom';\nimport { HydraAdmin, OpenApiAdmin } from '@api-platform/admin';\n\n// To use Hydra:\nconst Admin = () =\u003e \u003cHydraAdmin entrypoint=\"https://demo.api-platform.com\" /\u003e; // Replace with your own API entrypoint\n// To use OpenAPI (with a very simple REST data provider):\nconst Admin = () =\u003e \u003cOpenApiAdmin\n  docEntrypoint=\"https://demo.api-platform.com/docs.json\" // Replace with your own OpenAPI documentation entrypoint\n  entrypoint=\"https://demo.api-platform.com\" // Replace with your own API entrypoint\n/\u003e;\n\nReactDOM.render(\u003cAdmin /\u003e, document.getElementById('root'));\n```\n\nOr alternatively:\n\n```javascript\nimport React from 'react';\nimport ReactDOM from 'react-dom';\nimport {\n  AdminGuesser,\n  hydraDataProvider,\n  hydraSchemaAnalyzer,\n  openApiDataProvider,\n  openApiSchemaAnalyzer\n} from '@api-platform/admin';\nimport simpleRestProvider from 'ra-data-simple-rest';\n\n// Use your custom data provider or resource schema analyzer\n// Hydra:\nconst dataProvider = hydraDataProvider({ entrypoint: 'https://demo.api-platform.com' });\nconst schemaAnalyzer = hydraSchemaAnalyzer();\n// OpenAPI:\nconst dataProvider = openApiDataProvider({\n  // Use any data provider you like\n  dataProvider: simpleRestProvider('https://demo.api-platform.com'),\n  entrypoint: 'https://demo.api-platform.com',\n  docEntrypoint: 'https://demo.api-platform.com/docs.json',\n});\nconst schemaAnalyzer = openApiSchemaAnalyzer();\n\nconst Admin = () =\u003e (\n  \u003cAdminGuesser\n    dataProvider={dataProvider}\n    schemaAnalyzer={schemaAnalyzer}\n  /\u003e\n);\n\nReactDOM.render(\u003cAdmin /\u003e, document.getElementById('root'));\n```\n\n## Features\n\n* Automatically generates an admin interface for all the resources of the API thanks to the hypermedia features of Hydra or to the OpenAPI documentation\n* Generates 'list', 'create', 'show', and 'edit' screens, as well as a delete button\n* Generates suitable inputs and fields according to the API doc (e.g. number HTML input for numbers, checkbox for booleans, selectbox for relationships...)\n* Generates suitable inputs and fields according to Schema.org types if available (e.g. email field for `http://schema.org/email`)\n* Handles relationships\n* Supports pagination\n* Supports filters and ordering\n* Automatically validates whether a field is mandatory client-side according to the API description\n* Sends proper HTTP requests to the API and decodes them using Hydra and JSON-LD formats if available\n* Nicely displays server-side errors (e.g. advanced validation)\n* Supports real-time updates with [Mercure](https://mercure.rocks)\n* All the [features provided by React-admin](https://marmelab.com/react-admin/Tutorial.html) can also be used\n* **100% customizable**\n\n## Documentation\n\nThe documentation of API Platform Admin can be browsed [on the official website](https://api-platform.com/docs/admin/).\n\nCheck also the documentation of React-admin [on their official website](https://marmelab.com/react-admin/Tutorial.html).\n\n## Credits\n\nCreated by [Kévin Dunglas](https://dunglas.fr). Sponsored by [Les-Tilleuls.coop](https://les-tilleuls.coop).\nCommercial support available upon request.\n","funding_links":["https://github.com/sponsors/api-platform","https://opencollective.com/api-platform","https://tidelift.com/funding/github/packagist/api-platform/core"],"categories":["TypeScript","rest-api"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapi-platform%2Fadmin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fapi-platform%2Fadmin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapi-platform%2Fadmin/lists"}