{"id":13581153,"url":"https://github.com/pingidentity/astro","last_synced_at":"2025-04-13T00:31:40.813Z","repository":{"id":39600656,"uuid":"414319937","full_name":"pingidentity/astro","owner":"pingidentity","description":"React component library for Ping Identity's design system","archived":false,"fork":false,"pushed_at":"2025-04-03T20:45:12.000Z","size":617983,"stargazers_count":33,"open_issues_count":2,"forks_count":4,"subscribers_count":9,"default_branch":"master","last_synced_at":"2025-04-03T21:31:33.841Z","etag":null,"topics":["component-library","ping-identity","react","reactjs"],"latest_commit_sha":null,"homepage":"https://www.pingidentity.design","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pingidentity.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"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}},"created_at":"2021-10-06T18:04:16.000Z","updated_at":"2025-04-03T20:44:32.000Z","dependencies_parsed_at":"2024-03-27T21:24:28.990Z","dependency_job_id":"8be6074c-6cd5-49d9-babd-f4ab6bc7fa91","html_url":"https://github.com/pingidentity/astro","commit_stats":null,"previous_names":[],"tags_count":192,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pingidentity%2Fastro","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pingidentity%2Fastro/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pingidentity%2Fastro/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pingidentity%2Fastro/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pingidentity","download_url":"https://codeload.github.com/pingidentity/astro/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248650590,"owners_count":21139670,"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","ping-identity","react","reactjs"],"created_at":"2024-08-01T15:01:58.572Z","updated_at":"2025-04-13T00:31:35.793Z","avatar_url":"https://github.com/pingidentity.png","language":"TypeScript","funding_links":[],"categories":["TypeScript"],"sub_categories":[],"readme":"# `@pingux/astro`\n\nAstro is a lightweight, composable, and themeable React component library. Astro was created to help developers and designers create consistent, user friendly, and accessible UIs across all Ping products. Please visit https://pingidentity.design for more information. To read individual component documentation, [our Storybook docs site](https://storybook.pingidentity.design) is a great resource.\n\n## Installing\n\nTo consume Astro within your own project, install it via NPM or Yarn.\n\nNPM: \n`npm install @pingux/astro`\n\nYarn: \n`yarn add @pingux/astro`\n\n## Requirements\n\n- Node: 18+\n- React: 16.8+\n\n## Usage\n\nAll apps should be wrapped in an `\u003cAstroProvider\u003e` for full functionality and styling.\n\n```js\nimport { AstroProvider } from '@pingux/astro';\n\n\u003cAstroProvider\u003e\n  \u003cApp /\u003e\n\u003c/AstroProvider\u003e\n```\n\n## Running Storybook Locally\n\nAstro uses [Storybook](https://storybook.js.org/) for component documentation. Once Astro has been cloned, run the following commands to start a local Storybook server:\n\n`yarn start`\n\nThe Storybook server defaults to `https://localhost:6006`. This port can be customized by running the command start -p 9009. For example, this will start Storybook on port 9009. More information on customizing Storybook CLI options can be found at https://storybook.js.org/docs/react/api/cli-options. \n\nComponent prop documentation is available under the \"documentation\" tab per each component story. Most props can be toggled and configured for preview purposes within the prop table.\n\nFor example, to view the disabled button styling, navigate to the Button story’s props table, locate the \"isDisabled\" prop, and toggle to \"true\". This change allows you to preview the disabled button’s styling and functionality.\n\n## Yarn\nWe use a modern version of [Yarn](https://yarnpkg.com/getting-started) for package management with the [Plug'n'Play](https://yarnpkg.com/features/pnp) feature enabled. This allows for a [Zero Install](https://yarnpkg.com/features/zero-installs) approach to be used.\n\n## Enabling TypeScript in VSCode\n\nTo run TypeScript properly, there are a couple of steps to run first:\n\n1. Run `yarn dlx @yarnpkg/sdks vscode` and reload the window to configure vscode for TypeScript. \n2. Open a TypeScript file in VSCode and open the command palette with `cmd + shift + p`.\n    \n    a. Search for \"TypeScript: Select TypeScript Version...\"\n    \n    b. Choose \"Use Workspace Version\"\n\n## Browser Compatibility\n\nAstro fully supports the following browsers and versions:\n\n| Browser     | Version     |\n| ----------- | ----------- |\n| Chrome      | 80+         |\n| Firefox     | 76+         |\n| Safari      | 12+         |\n| Edge        | 44+         |\n\n\nSupport for IE11 is left up to developers and is not tested by the Astro team. Polyfills are necessary for full functionality.\n\n## Changelog\n\nAstro’s [changelog](CHANGELOG.md) notes all features and bug fixes within each release. Refactors and documentation updates are not included within the changelog.\n\n## Contributing and Bug Reports\n\nAstro is closed for open contributions. However, we are appreciative of bug reports and suggestions. Please use GitHub Issues to submit bug reports and suggestions.\n\n## VS Code Linting\nThe Astro development team prefers to use VS Code as a code editor. To enable code highlighting and autolinting on save you will need to install the ESLint, Prettier and ZipFS plugins, plus add the \nfollowing settings in your `settings.json` file. \n\n```\n{\n  \"eslint.format.enable\": true,\n  \"editor.codeActionsOnSave\": {\n      \"source.fixAll.eslint\": true\n  },\n  \"eslint.validate\": [\n      \"javascript\",\n  ],\n}\n```\n\nYou will need to have the monorepo open at the root directory in VS Code for linting and highlighting to work.\n\nNote: To make linting and highlighting work with Yarn 2, `yarn dlx @yarnpkg/sdks vscode` needs to be run in the root directory of the monorepo. If any changes are made to any \nESLint packages or versions these features may stop working. Run this command again to solve the issue. Be sure to commit the changes so others don't run into the same issue. \n\n## Licensing\n\nThis project is licensed under the Apache 2.0 license. See the [LICENSE](LICENSE) file for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpingidentity%2Fastro","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpingidentity%2Fastro","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpingidentity%2Fastro/lists"}