{"id":15007722,"url":"https://github.com/builtnorth/wp-component-library","last_synced_at":"2026-03-11T08:02:05.197Z","repository":{"id":255933386,"uuid":"853542242","full_name":"builtnorth/wp-component-library","owner":"builtnorth","description":"Library of components for use in the WordPress block editor.","archived":false,"fork":false,"pushed_at":"2026-03-04T05:44:58.000Z","size":465,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-04T11:50:26.886Z","etag":null,"topics":["block-library","npm-package","wordpress","wp-components"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/@builtnorth/wp-component-library","language":"JavaScript","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/builtnorth.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-09-06T21:44:18.000Z","updated_at":"2025-10-18T19:20:19.000Z","dependencies_parsed_at":"2024-09-07T23:39:22.872Z","dependency_job_id":"55e9472c-c657-46cd-8ea9-08f11036bdca","html_url":"https://github.com/builtnorth/wp-component-library","commit_stats":null,"previous_names":["builtnorth/wp-component-library"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/builtnorth/wp-component-library","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/builtnorth%2Fwp-component-library","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/builtnorth%2Fwp-component-library/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/builtnorth%2Fwp-component-library/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/builtnorth%2Fwp-component-library/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/builtnorth","download_url":"https://codeload.github.com/builtnorth/wp-component-library/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/builtnorth%2Fwp-component-library/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30375478,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-11T06:09:32.197Z","status":"ssl_error","status_checked_at":"2026-03-11T06:09:17.086Z","response_time":84,"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":["block-library","npm-package","wordpress","wp-components"],"created_at":"2024-09-24T19:13:31.561Z","updated_at":"2026-03-11T08:02:05.178Z","avatar_url":"https://github.com/builtnorth.png","language":"JavaScript","readme":"# WP Component Library\n\nA comprehensive library of reusable components for WordPress block development, providing UI controls, media management, layout tools, and advanced input components.\n\n## Installation\n\n```bash\nnpm install @builtnorth/wp-component-library\n```\n\n## Components\n\n### Media \u0026 Images\n\n- [**AttachmentImage**](./components/attachment-image/README.md) - WordPress media attachment display with responsive features\n- [**Media**](./components/media/README.md) - Complete media upload suite for toolbar, editor, and inspector contexts\n\n### Layout \u0026 Structure\n\n- [**Layout**](./components/layout/README.md) - Flexbox layout controls with alignment, justification, and orientation\n- [**SectionSettings**](./components/section-settings/README.md) - Section-level background and styling controls\n- [**SectionDivider**](./components/section-divider/README.md) - Decorative dividers for section blocks\n- [**SectionPattern**](./components/section-pattern/README.md) - SVG background patterns with positioning controls\n\n### Form \u0026 Input\n\n- [**AttributesPanel**](./components/attributes-panel/README.md) - Dynamic attribute management for Site Editor blocks\n- [**Button**](./components/button/README.md) - Frontend button component with style variants\n- [**CaptchaPlaceholder**](./components/captcha-placeholder/README.md) - Unified captcha interface for multiple providers\n- [**VariableField**](./components/variable-field/README.md) - Input with @ triggered variable autocomplete\n- [**VariableInserter**](./components/variable-inserter/README.md) - Variable insertion tool for template fields\n\n### Data \u0026 Content\n\n- [**Query**](./components/query/README.md) - Query builder controls for post selection\n- [**Meta**](./components/meta/README.md) - Meta field management and selection tools\n- [**Repeater**](./components/repeater/README.md) - Drag-and-drop repeater field with flexible content\n- [**SortableSelect**](./components/sortable-select/README.md) - Multi-select with drag-to-reorder functionality\n\n### Editor Tools\n\n- [**BlockAppender**](./components/block-appender/README.md) - Customizable block appenders for different contexts\n\n## Quick Start\n\n### Media Upload Example\n\n```jsx\nimport { InspectorMediaUpload } from \"@builtnorth/wp-component-library/components/media\";\n\n\u003cInspectorMediaUpload\n\tbuttonTitle=\"Upload Logo\"\n\tonSelect={handleImageSelect}\n\tonRemove={handleImageRemove}\n\timageId={logoId}\n\timageUrl={logoUrl}\n/\u003e;\n```\n\n### Layout Controls Example\n\n```jsx\nimport { LayoutPanel } from \"@builtnorth/wp-component-library/components/layout\";\n\n\u003cLayoutPanel\n\torientation={orientation}\n\tonOrientationChange={setOrientation}\n\tjustification={justification}\n\tonJustificationChange={setJustification}\n\talignment={alignment}\n\tonAlignmentChange={setAlignment}\n/\u003e;\n```\n\n### Variable Field Example\n\n```jsx\nimport { VariableField } from \"@builtnorth/wp-component-library/components/variable-field\";\n\n\u003cVariableField\n\tvalue={content}\n\tonChange={setContent}\n\toptions={[\n\t\t{ label: \"User Name\", value: \"{user_name}\" },\n\t\t{ label: \"Site Title\", value: \"{site_title}\" },\n\t]}\n\tplaceholder=\"Type @ to insert variables\"\n/\u003e;\n```\n\n### Repeater Example\n\n```jsx\nimport { Repeater } from \"@builtnorth/wp-component-library/components/repeater\";\n\n\u003cRepeater\n\titems={items}\n\trenderItem={renderItem}\n\tonAdd={handleAdd}\n\tonRemove={handleRemove}\n\tonReorder={handleReorder}\n\taddButtonText=\"Add Item\"\n/\u003e;\n```\n\n## Component Categories\n\n### 🖼️ Media Components\n\nHandle image uploads, display, and media management across different editor contexts.\n\n### 📐 Layout Components\n\nControl flexbox layouts, alignment, spacing, and responsive design settings.\n\n### 📝 Input Components\n\nAdvanced form fields with features like autocomplete, variable insertion, and validation.\n\n### 📊 Data Components\n\nQuery builders, meta field selectors, and content management tools.\n\n### 🎨 Style Components\n\nSection styling, backgrounds, patterns, and visual dividers.\n\n### 🔧 Utility Components\n\nHelper components for common WordPress block editor tasks.\n\n## Features\n\n- **WordPress Integration** - Deep integration with WordPress block editor APIs\n- **Customizable** - Flexible props and styling options\n- **TypeScript Ready** - Full TypeScript definitions available\n- **Tree-Shakeable** - Import only what you need\n\n## Requirements\n\n- WordPress 6.0+\n- @wordpress/scripts\n- React 18+\n\n## Documentation\n\nEach component has detailed documentation in its respective README file. Click on any component name above to view its full documentation including:\n\n- Detailed usage examples\n- Complete prop definitions\n- Integration patterns\n- Best practices\n- Code snippets\n\n## Disclaimer\n\nThis component library is provided \"as is\" without warranty of any kind, express or implied. Use at your own risk. The authors and contributors are not responsible for any damages or liabilities arising from the use of this library. Always test components thoroughly in your specific environment before deploying to production.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbuiltnorth%2Fwp-component-library","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbuiltnorth%2Fwp-component-library","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbuiltnorth%2Fwp-component-library/lists"}