{"id":15195647,"url":"https://github.com/omnedia/ngx-three-globe","last_synced_at":"2026-02-03T11:34:00.143Z","repository":{"id":253917465,"uuid":"844704743","full_name":"omnedia/ngx-three-globe","owner":"omnedia","description":"A simple component library to create a container with an animated globe with archs.","archived":false,"fork":false,"pushed_at":"2025-11-29T17:12:58.000Z","size":194,"stargazers_count":1,"open_issues_count":0,"forks_count":2,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-12-01T17:53:54.240Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/omnedia.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-08-19T20:01:57.000Z","updated_at":"2025-11-29T17:09:06.000Z","dependencies_parsed_at":"2024-08-20T10:41:13.603Z","dependency_job_id":"44739898-8add-47ed-9056-243e89db0de4","html_url":"https://github.com/omnedia/ngx-three-globe","commit_stats":{"total_commits":4,"total_committers":2,"mean_commits":2.0,"dds":0.25,"last_synced_commit":"0dfb9a446e0db3c9cab1865ac7473591bcceb852"},"previous_names":["omnedia/ngx-three-globe"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/omnedia/ngx-three-globe","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/omnedia%2Fngx-three-globe","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/omnedia%2Fngx-three-globe/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/omnedia%2Fngx-three-globe/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/omnedia%2Fngx-three-globe/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/omnedia","download_url":"https://codeload.github.com/omnedia/ngx-three-globe/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/omnedia%2Fngx-three-globe/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29044368,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-03T10:09:22.136Z","status":"ssl_error","status_checked_at":"2026-02-03T10:09:16.814Z","response_time":96,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: 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":[],"created_at":"2024-09-27T23:43:03.526Z","updated_at":"2026-02-03T11:34:00.128Z","avatar_url":"https://github.com/omnedia.png","language":"TypeScript","funding_links":[],"categories":["Framework Interoperability","Recently Updated"],"sub_categories":["Wrappers","[Oct 01, 2024](/content/2024/10/01/README.md)"],"readme":"# ngx-three-globe\n\n\u003ca href=\"https://ngxui.com\" target=\"_blank\" style=\"display: flex;gap: .5rem;align-items: center;cursor: pointer; padding: 0 0 0 0; height: fit-content;\"\u003e\n  \u003cimg src=\"https://ngxui.com/assets/img/ngxui-logo.png\" style=\"width: 64px;height: 64px;\"\u003e\n\u003c/a\u003e\n\nThis Library is part of the NGXUI ecosystem. \u003cbr\u003e\nView all available components at https://ngxui.com\n\n`@omnedia/ngx-three-globe` is an Angular library that provides an interactive, 3D globe visualization built using three-globe and three.js. This component offers customizable globe settings, light sources, and animated arcs and rings, making it perfect for data visualization or adding dynamic elements to your Angular applications.\n\n## Features\n\n- Fully interactive 3D globe visualization with customizable settings.\n- Animated arcs and rings for displaying data between different locations on the globe.\n- Customizable globe appearance, including atmosphere, lighting, and rotation.\n- Built using three-globe and three.js for smooth rendering and interaction.\n\n## Installation\n\nInstall the library and the required peer dependencies using npm:\n\n```bash\nnpm install @omnedia/ngx-three-globe three three-globe\nnpm i --save-dev @types/three\n```\n\nBoth three-globe and three are required as peer dependencies for this library to function correctly.\n\n## Usage\n\nImport the `NgxThreeGlobeComponent` in your Angular module or component:\n\n```typescript\nimport {NgxThreeGlobeComponent} from '@omnedia/ngx-three-globe';\n\n@Component({\n  ...\n    imports:\n[\n  ...\n    NgxThreeGlobeComponent,\n],\n...\n})\n```\n\nUse the component in your template:\n\n```html\n\n\u003com-three-globe\n  [globeSize]=\"'800px'\"\n  [globeConfig]=\"{\n    globeColor: '#062056',\n    atmosphereColor: '#ffffff',\n    autoRotate: true,\n    autoRotateSpeed: 1\n  }\"\n  [arcAndRingColors]=\"['#06b6d4', '#3b82f6', '#6366f1']\"\n  styleClass=\"custom-globe-class\"\n\u003e\u003c/om-three-globe\u003e\n```\n\n## API\n\n```html\n\n\u003com-three-globe\n  [globeSize]=\"globeSize\"\n  [globeConfig]=\"globeConfig\"\n  [arcAndRingColors]=\"arcAndRingColors\"\n  [arcs]=\"ThreeGlobePosition[]\"\n  styleClass=\"your-custom-class\"\n\u003e\n\u003c/om-three-globe\u003e\n```\n\n- `globeSize` (optional): The size of the globe in pixels. Accepts a string value such as '600px' or '100%'. Defaults to '600px'.\n- `globeConfig` (optional): A configuration object that defines the appearance and behavior of the globe, including lighting, atmosphere, rotation, and more. See the configuration options below.\n- `arcAndRingColors` (optional): An array of color strings used to customize the arcs and rings displayed on the globe. They will get random colors from this array.\n- `arcs` (optional): An array of ThreeGlobePosition objects used to add customized arcs if the default ones arent whats needed.\n- `styleClass` (optional): A custom CSS class to apply to the globe's wrapper element for additional styling.\n\n## Example\n\n```html\n\n\u003com-three-globe\n  [globeSize]=\"'500px'\"\n  [globeConfig]=\"{\n    globeColor: '#0a2f5b',\n    showAtmosphere: true,\n    atmosphereColor: '#f5f5f5',\n    autoRotate: true,\n    autoRotateSpeed: 0.8,\n    pointLight: '#ffffff'\n  }\"\n  [arcAndRingColors]=\"['#ff6b6b', '#f06595', '#faa2c1']\"\n  styleClass=\"globe-custom-style\"\n\u003e\u003c/om-three-globe\u003e\n```\n\nThis example creates a globe with custom colors, atmosphere, and rotation speed, along with animated arcs connecting various points.\n\n## Globe Configuration Options\n\nThe `globeConfig` input allows you to configure various aspects of the globe's appearance and behavior:\n\n- `pointSize`: The size of points on the globe.\n- `globeColor`: The main color of the globe.\n- `showAtmosphere`: A boolean to toggle the atmosphere effect around the globe.\n- `atmosphereColor`: The color of the atmosphere surrounding the globe.\n- `atmosphereAltitude`: The altitude of the atmosphere.\n- `emissive`: The emissive color of the globe's material.\n- `emissiveIntensity`: The intensity of the globe's emissive color.\n- `shininess`: The shininess of the globe's surface.\n- `polygonColor`: The color of polygons on the globe (e.g., country borders).\n- `ambientLight`: The color of the ambient light.\n- `directionalLeftLight`: The color of the left directional light.\n- `directionalTopLight`: The color of the top directional light.\n- `pointLight`: The color of the point light.\n- `arcTime`: The duration of the arc animation.\n- `arcLength`: The length of the animated arcs.\n- `rings`: The number of rings around the globe.\n- `maxRings`: The maximum number of rings allowed.\n- `manualRotate`: A boolean to enable or disable manual rotation of the globe.\n- `autoRotate`: A boolean to enable or disable automatic rotation of the globe.\n- `autoRotateSpeed`: The speed at which the globe rotates automatically.\n\n## Dependencies\n\nThis library relies on the following peer dependencies for rendering and interactivity:\n\n- `three` - The 3D rendering library used to create and manage 3D scenes.\n- `three-globe` - A library built on three.js for creating and animating globes with custom data visualizations.\n\nEnsure that both of these dependencies are installed alongside the library.\n\n```bash\nnpm install three three-globe --save\n```\n\n## Styling\n\nTo customize the appearance of the globe or container, use the styleClass input to apply your own CSS classes.\n\n```css\n.globe-custom-style {\n  background-color: #000;\n  border-radius: 50%;\n  box-shadow: 0 0 20px rgba(255, 255, 255, 0.5);\n}\n```\n\n## Contributing\n\nContributions are welcome. Please submit a pull request or open an issue to discuss your ideas.\n\n## License\n\nThis project is licensed under the MIT License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fomnedia%2Fngx-three-globe","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fomnedia%2Fngx-three-globe","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fomnedia%2Fngx-three-globe/lists"}