{"id":30676462,"url":"https://github.com/pewu/topola-viewer","last_synced_at":"2025-09-01T10:14:08.000Z","repository":{"id":39319942,"uuid":"167267743","full_name":"PeWu/topola-viewer","owner":"PeWu","description":"Topola Genealogy Viewer – interactive genealogy visualization","archived":false,"fork":false,"pushed_at":"2025-08-03T21:59:44.000Z","size":51297,"stargazers_count":265,"open_issues_count":58,"forks_count":58,"subscribers_count":16,"default_branch":"master","last_synced_at":"2025-08-03T23:37:04.575Z","etag":null,"topics":["family-tree","gedcom","genealogy","visualization"],"latest_commit_sha":null,"homepage":"https://pewu.github.io/topola-viewer","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/PeWu.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,"zenodo":null}},"created_at":"2019-01-23T23:04:24.000Z","updated_at":"2025-08-03T21:59:47.000Z","dependencies_parsed_at":"2024-03-28T18:29:46.069Z","dependency_job_id":"276be953-e883-4d6d-b588-a3d2da3df720","html_url":"https://github.com/PeWu/topola-viewer","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/PeWu/topola-viewer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PeWu%2Ftopola-viewer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PeWu%2Ftopola-viewer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PeWu%2Ftopola-viewer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PeWu%2Ftopola-viewer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PeWu","download_url":"https://codeload.github.com/PeWu/topola-viewer/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PeWu%2Ftopola-viewer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273105956,"owners_count":25046950,"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","status":"online","status_checked_at":"2025-09-01T02:00:09.058Z","response_time":120,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["family-tree","gedcom","genealogy","visualization"],"created_at":"2025-09-01T10:14:07.003Z","updated_at":"2025-09-01T10:14:07.988Z","avatar_url":"https://github.com/PeWu.png","language":"TypeScript","funding_links":["https://www.buymeacoffee.com/pewu"],"categories":[],"sub_categories":[],"readme":"# Topola Genealogy Viewer\n\n[![Node.js CI](https://github.com/PeWu/topola-viewer/actions/workflows/node.js.yml/badge.svg)](https://github.com/PeWu/topola-viewer/actions/workflows/node.js.yml)\n\nView your genealogy data using an interactive chart.\n\nWebsite: https://pewu.github.io/topola-viewer\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://pewu.github.io/topola-viewer/#/view?url=http%3A%2F%2Fgenpol.com%2Fmodule-Downloads-prep_hand_out-lid-32.html\"\u003e\n    \u003cimg src=\"screenshot.png\" width=\"320\" alt=\"screenshot\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\nIf you find this project useful, consider buying me a coffee.\n\n[![buy me a coffee](https://www.buymeacoffee.com/assets/img/custom_images/yellow_img.png)](https://www.buymeacoffee.com/pewu)\n\n## Features\n* Hourglass chart\n* All relatives chart\n* Click on a person to focus\n* Open standard GEDCOM files you can export from any genealogy application\n* Load from URL (just point to a GEDCOM file on the Web)\n* Privacy – your files do not leave your computer\n* Print the whole genealogy tree\n* Export to PDF, PNG, SVG\n* Side panel with details\n* Configuration options\n* Permalinks when loading from URL\n* Cool transition animations\n\n[Changelog](CHANGELOG.md)\n\n## Examples\n\nHere is an example from the Web:\n\n* [J. F. Kennedy](https://pewu.github.io/topola-viewer/#/view?url=https%3A%2F%2Fchronoplexsoftware.com%2Fmyfamilytree%2Fsamples%2FThe%2520Kennedy%2520Family.gdz) (from [https://chronoplexsoftware.com/myfamilytree/samples/](chronoplexsoftware.com))\n* [Shakespeare](https://pewu.github.io/topola-viewer/#/view?url=https%3A%2F%2Fwebtreeprint.com%2Ftp_downloader.php%3Fpath%3Dfamous_gedcoms%2Fshakespeare.ged%26file%3Dshakespeare.ged) (from [webtreeprint.com](https://webtreeprint.com/tp_famous_gedcoms.php))\n* [Maria Skłodowska-Curie](https://pewu.github.io/topola-viewer/#/view?indi=Sk%C5%82odowska-2\u0026source=wikitree) (from [WikiTree](https://www.wikitree.com/wiki/Sk%C5%82odowska-2))\n\nIf you have data in a genealogy database, you can export your data in GEDCOM format and load it using the \"Load from file\" menu.\n\n## Integrations\n\nTopola Genealogy Viewer is being integrated into more and more Web and desktop applications.\nHere are the current integrations:\n\n### Gramps\n\nTo view your [Gramps](https://gramps-project.org/) data in Topola Genealogy Viewer,\ninstall [*Interactive Family Tree*](https://gramps-project.org/wiki/index.php/Interactive_Family_Tree)\nplugin from the Gramps plugin manager. The plugin will add a\n*Tools-\u003eAnalysis and Exploration-\u003eInteractive Family Tree* menu item to Gramps.\n\nSource code: https://github.com/gramps-project/addons-source/tree/master/Topola\n\n### Webtrees\n\nEmbed Topola Genealogy Viewer in your [Webtrees](https://www.webtrees.net/) installation with the\n[Topola interactive tree addon](https://webtrees.net/download/modules#simple-auto-login---by-fanningert---20---website).\n\nSource code: https://github.com/PeWu/topola-webtrees\n\n### WikiTree\n\nYou can browse the [WikiTree](https://www.wikitree.com/) genealogy tree using Topola Genealogy Viewer.\nOn a WikiTree profile page go to the *Family Tree \u0026 Tools* tab and click the *Dynamic Tree by Topola* link.\n\nExample:\n[Stephen Hawking](https://apps.wikitree.com/apps/wiech13/topola-viewer/#/view?source=wikitree\u0026standalone=false\u0026indi=Hawking-7)\n\nTopola Genealogy Viewer is hosted on [apps.wikitree.com](https://apps.wikitree.com/apps/wiech13/topola-viewer)\nto benefit from the ability of being logged in to the WikiTree API.\n\n## Running locally\n\n```\nnpm install\nnpm start\n```\n\n## Self-hosting\n\nYou can host Topola Genealogy Viewer on your own server. There are no specific requirements for the hosting server. There is no code that is executed on the server side. The server only hosts the application files and whole application runs in the browser.\n\nYou can build Topola Genealogy Viewer from source code or take a ready-to-deploy package.\n\n### Bulid your own\n\nHere are the commands to build the application:\n```\ngit clone https://github.com/PeWu/topola-viewer.git\ncd topola-viewer\nnpm install\nnpm run build\n```\nNow, take the contents of the `dist/` folder and host it on your own server.\n\n### Use an existing package\n\nDownload the following file, unpack it and upload the contents to your server:\nhttps://github.com/PeWu/topola-viewer/archive/refs/heads/gh-pages.zip\n\nThese are the exact files that are hosted on GitHub pages.\n\n### Build for your own data only\n\nYou can run Topola Viewer in a \"single tree mode\" that displays only the GEDCOM you specify. Specify the URL to a GEDCOM file in the `VITE_STATIC_URL` environment variable when building and running the application.\n\nRun locally with the specified data URL:\n```\nVITE_STATIC_URL=https://example.org/sample.ged npm start\n```\n\nBuild with the specified data URL:\n```\nVITE_STATIC_URL=https://example.org/sample.ged npm run build\n```\nThe `dist/` folder will contain files that can be hosted on a Web server.\n\n### Alternative build\n\nThe [topola-webpack](https://github.com/develancer/topola-webpack) tool can build a Topola Genealogy Viewer package bundled together with a GEDCOM file.\n\n## Additional options\n\n### `handleCors`\n\nAdd `\u0026handleCors=false` to the URL to avoid using the CORS proxy\n\n### `embedded`\n\nAdd `\u0026embedded=true` to the URL. This option removes the options to open a different file. It is an option that was intended to be used when Topola Genealogy Viewer is in an iframe.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpewu%2Ftopola-viewer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpewu%2Ftopola-viewer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpewu%2Ftopola-viewer/lists"}