{"id":25507940,"url":"https://github.com/zilbam/react-perspective-transform","last_synced_at":"2025-04-10T12:56:50.905Z","repository":{"id":272616305,"uuid":"917241482","full_name":"ZilbaM/react-perspective-transform","owner":"ZilbaM","description":"A React Component library for perspective transformation and projection mapping","archived":false,"fork":false,"pushed_at":"2025-02-06T16:20:38.000Z","size":24082,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-19T16:38:57.048Z","etag":null,"topics":["component-library","frontend","javascript","perspective-transformation","projection-mapping","react","typescript-react"],"latest_commit_sha":null,"homepage":"https://zilbam.github.io/react-perspective-transform/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ZilbaM.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2025-01-15T16:11:32.000Z","updated_at":"2025-02-06T16:20:41.000Z","dependencies_parsed_at":"2025-01-16T15:08:53.481Z","dependency_job_id":"5753375c-7ef2-49e8-afb0-e58fcef79cc2","html_url":"https://github.com/ZilbaM/react-perspective-transform","commit_stats":null,"previous_names":["petit-polisson/perspective-transform","zilbam/perspective-transform","zilbam/react-perspective-transform"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZilbaM%2Freact-perspective-transform","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZilbaM%2Freact-perspective-transform/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZilbaM%2Freact-perspective-transform/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZilbaM%2Freact-perspective-transform/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ZilbaM","download_url":"https://codeload.github.com/ZilbaM/react-perspective-transform/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248222609,"owners_count":21067813,"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":["component-library","frontend","javascript","perspective-transformation","projection-mapping","react","typescript-react"],"created_at":"2025-02-19T07:55:19.302Z","updated_at":"2025-04-10T12:56:50.884Z","avatar_url":"https://github.com/ZilbaM.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# React Perspective Transform\n\nA lightweight **React** component that applies a perspective transform to its children, allowing you to manipulate each corner independently. Perfect for interactive demos, image warping, or advanced UI effects.\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](./LICENSE)\n\n## Overview\n\n`react-perspective-transform` handles corner-based transformations with just CSS `matrix3d`, preserving the crispness of text and images. It supports:\n\n- **Draggable Corners**: Press \u003ckbd\u003eShift + P\u003c/kbd\u003e (or custom keys) to toggle edit mode.\n- **Controlled or Uncontrolled** usage\n- **Optional Local Storage** persistence\n- **Matrix-based transforms** for smooth performance\n\nFor detailed documentation, including advanced usage, API reference, and guides, visit the **[official docs site](https://zilbam.github.io/react-perspective-transform)**.\n\n---\n\n## Installation\n\n```bash\nnpm install react-perspective-transform\n# or\nyarn add react-perspective-transform\n```\n\n## Quick Start\n\n```tsx\nimport React from 'react';\nimport PerspectiveTransform from 'react-perspective-transform';\n\nexport default function App() {\n  return (\n    \u003cdiv style={{ width: 400, height: 300, border: '1px solid #ccc' }}\u003e\n      \u003cPerspectiveTransform\u003e\n        \u003cimg src=\"/path/to/image.jpg\" alt=\"Warp Me\" style={{ width: '100%' }} /\u003e\n      \u003c/PerspectiveTransform\u003e\n    \u003c/div\u003e\n  );\n}\n```\n\n1. **Wrap your content** in `\u003cPerspectiveTransform\u003e`.\n2. **Press \u003ckbd\u003eShift + P\u003c/kbd\u003e** in the browser to toggle edit mode and drag corners.\n3. Adjust the parent container’s width and height to see real transformations.\n\n---\n\n## Documentation\n\nLooking for **advanced guides**, **API reference**, or **contribution docs**?\nCheck out the **[Complete Documentation](./docs/intro.md)** for:\n\n- **Controlled vs. Uncontrolled** usage  \n- **Edit Mode** configuration and hotkeys  \n- **Persistence** with `storageKey`  \n- **TypeDoc** API reference  \n- **FAQ** and more\n\n---\n\n## Contributing\n\n1. **Clone the repository**:\n   ```bash\n   git clone https://github.com/ZilbaM/react-perspective-transform.git\n   cd react-perspective-transform\n   ```\n\n2. **Install dependencies**:\n   ```bash\n   npm install\n   ```\n\n3. **Build**:\n   ```bash\n   npm run build\n   ```\n\n5. **Open a pull request**:\n   - Please open an issue to discuss major changes.\n   - Ensure tests pass and updates are covered.\n\n---\n\n## License\n\n[MIT License](./LICENSE) © 2025 ZilbaM\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzilbam%2Freact-perspective-transform","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzilbam%2Freact-perspective-transform","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzilbam%2Freact-perspective-transform/lists"}