{"id":13401854,"url":"https://github.com/visjs/vis-timeline","last_synced_at":"2025-05-12T11:17:11.319Z","repository":{"id":37271537,"uuid":"197730309","full_name":"visjs/vis-timeline","owner":"visjs","description":"📅 Create a fully customizable, interactive timelines and 2d-graphs with items and ranges.","archived":false,"fork":false,"pushed_at":"2025-05-10T16:52:31.000Z","size":1499407,"stargazers_count":2064,"open_issues_count":298,"forks_count":339,"subscribers_count":27,"default_branch":"master","last_synced_at":"2025-05-11T11:09:22.739Z","etag":null,"topics":["chart","hacktoberfest","timeline","vis"],"latest_commit_sha":null,"homepage":"https://visjs.github.io/vis-timeline/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/visjs.png","metadata":{"files":{"readme":"README.md","changelog":"HISTORY.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE.Apache-2.0.txt","code_of_conduct":"CODE-OF-CONDUCT.md","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},"funding":{"github":null,"patreon":null,"open_collective":"visjs","ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":null}},"created_at":"2019-07-19T08:06:00.000Z","updated_at":"2025-05-10T22:08:23.000Z","dependencies_parsed_at":"2025-04-23T10:23:21.091Z","dependency_job_id":null,"html_url":"https://github.com/visjs/vis-timeline","commit_stats":{"total_commits":3544,"total_committers":209,"mean_commits":16.95693779904306,"dds":0.7183972911963883,"last_synced_commit":"65864309790b2898519d5b0f66ec87aac1e90172"},"previous_names":[],"tags_count":72,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/visjs%2Fvis-timeline","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/visjs%2Fvis-timeline/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/visjs%2Fvis-timeline/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/visjs%2Fvis-timeline/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/visjs","download_url":"https://codeload.github.com/visjs/vis-timeline/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253554085,"owners_count":21926613,"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":["chart","hacktoberfest","timeline","vis"],"created_at":"2024-07-30T19:01:07.988Z","updated_at":"2025-05-11T11:09:29.790Z","avatar_url":"https://github.com/visjs.png","language":"JavaScript","readme":"# vis-timeline\n\n![example chart](docs/img/timeline.png)\n\nThe Timeline/Graph2D is an interactive visualization chart to visualize data in time. The data items can take place on a single date, or have a start and end date (a range). You can freely move and zoom in the timeline by dragging and scrolling in the Timeline. Items can be created, edited, and deleted in the timeline. The time scale on the axis is adjusted automatically, and supports scales ranging from milliseconds to years.\n\n## Badges\n\n[![GitHub contributors](https://img.shields.io/github/contributors/visjs/vis-timeline.svg)](https://github.com/visjs/vis-timeline/graphs/contributors)\n[![GitHub stars](https://img.shields.io/github/stars/visjs/vis-timeline.svg)](https://github.com/almende/vis/stargazers)\n\n[![Backers on Open Collective](https://opencollective.com/visjs/backers/badge.svg)](#backers) [![Sponsors on Open Collective](https://opencollective.com/visjs/sponsors/badge.svg)](#sponsors) \n\n## Install\n\nInstall via npm:\n\n    $ npm install vis-timeline\n\n## Example\n\nA basic example on loading a Timeline is shown below. More examples can be\nfound in the [examples directory](https://github.com/visjs/vis-timeline/tree/master/examples/)\nof the project.\n\n```html\n\u003c!doctype html\u003e\n\u003chtml\u003e\n\u003chead\u003e\n  \u003ctitle\u003eTimeline\u003c/title\u003e\n  \u003cscript type=\"text/javascript\" src=\"https://unpkg.com/vis-timeline@latest/standalone/umd/vis-timeline-graph2d.min.js\"\u003e\u003c/script\u003e\n  \u003clink href=\"https://unpkg.com/vis-timeline@latest/styles/vis-timeline-graph2d.min.css\" rel=\"stylesheet\" type=\"text/css\" /\u003e\n  \u003cstyle type=\"text/css\"\u003e\n    #visualization {\n      width: 600px;\n      height: 400px;\n      border: 1px solid lightgray;\n    }\n  \u003c/style\u003e\n\u003c/head\u003e\n\u003cbody\u003e\n\u003cdiv id=\"visualization\"\u003e\u003c/div\u003e\n\u003cscript type=\"text/javascript\"\u003e\n  // DOM element where the Timeline will be attached\n  var container = document.getElementById('visualization');\n\n  // Create a DataSet (allows two way data-binding)\n  var items = new vis.DataSet([\n    {id: 1, content: 'item 1', start: '2014-04-20'},\n    {id: 2, content: 'item 2', start: '2014-04-14'},\n    {id: 3, content: 'item 3', start: '2014-04-18'},\n    {id: 4, content: 'item 4', start: '2014-04-16', end: '2014-04-19'},\n    {id: 5, content: 'item 5', start: '2014-04-25'},\n    {id: 6, content: 'item 6', start: '2014-04-27', type: 'point'}\n  ]);\n\n  // Configuration for the Timeline\n  var options = {};\n\n  // Create a Timeline\n  var timeline = new vis.Timeline(container, items, options);\n\u003c/script\u003e\n\u003c/body\u003e\n\u003c/html\u003e\n```\n\n## Builds\n\nThere are four builds provided at the moment.\n\n### Standalone build\n\n```html\n\u003cscript\n  type=\"text/javascript\"\n  src=\"https://unpkg.com/vis-timeline@latest/standalone/umd/vis-timeline-graph2d.min.js\"\n\u003e\u003c/script\u003e\n```\n\n```javascript\nimport { Timeline } from \"vis-timeline/standalone\";\n```\n\nThis has no dependencies and therefore is great for things like MWEs but has\nmore issues with interoperability and bundle bloat. For more information see the\nfollowing [example](https://visjs.github.io/vis-timeline/examples/timeline/standalone-build.html).\n\n### Peer build\n\n```html\n\u003cscript\n  type=\"text/javascript\"\n  src=\"https://unpkg.com/vis-timeline@latest/peer/umd/vis-timeline-graph2d.min.js\"\n\u003e\u003c/script\u003e\n```\n\n```javascript\nimport { Timeline } from \"vis-timeline/peer\";\n```\n\nFor this build to work you have to load Vis Data and Moment (including locales\nexcept English) packages yourself. The advantage here is that it works well with\nother packages. For more information see the following [example](https://visjs.github.io/vis-timeline/examples/timeline/peer-build.html).\n\n### ESNext build\n\n```html\n\u003cscript\n  type=\"text/javascript\"\n  src=\"https://unpkg.com/vis-timeline@latest/esnext/umd/vis-timeline-graph2d.min.js\"\n\u003e\u003c/script\u003e\n```\n\n```javascript\nimport { Timeline } from \"vis-timeline/esnext\";\n```\n\nThis is the same as the peer build but without any bundled dependencies or\npollyfills. It's indented to be used with bundlers like Rollup or Webpack which\nwill fetch the dependencies, prevent duplicate dependencies in the bundle, use\ntranspilers to add necessary polyfills etc.\n\n### Legacy build\n\n```html\n\u003cscript\n  type=\"text/javascript\"\n  src=\"https://unpkg.com/vis-timeline@latest/dist/vis-timeline-graph2d.min.js\"\n\u003e\u003c/script\u003e\n```\n\n```javascript\nimport { Timeline } from \"vis-timeline\";\n```\n\nThis is solely kept for backwards compatibility. It is deprecated and will be\nremoved in case of URLs and replaced by the peer build in case of\nNode.js/bundlers. Don't use this, please.\n\n## Build\n\nTo build the library from source, clone the project from github\n\n    $ git clone git://github.com/visjs/vis-timeline.git\n\nThe source code uses the module style of node (require and module.exports) to\norganize dependencies. To install all dependencies and build the library,\nrun `npm install` in the root of the project.\n\n    $ cd vis-timeline\n    $ npm install\n\nThen, the project can be build running:\n\n    $ npm run build\n\n### Excluding external dependencies\n\nExternal dependencies such as moment, hammerjs can be excluded in the build by running:\n\n    $ npm run build -- -e [comma separated module names]\n\nExample:\n\n    $ npm run build -- -e moment,hammerjs\n\n## Test\n\nTo test the library, install the project dependencies once:\n\n    $ npm install\n\nThen run the tests:\n\n    $ npm run test\n\n## Contribute\n\nContributions to the vis.js library are very welcome! We can't do this alone!\n\n### Backers\n\nThank you to all our backers! 🙏\n\n\u003ca href=\"https://opencollective.com/visjs#backers\" target=\"_blank\"\u003e\u003cimg src=\"https://opencollective.com/visjs/backers.svg?width=890\"\u003e\u003c/a\u003e\n\n### Sponsors\n\nSupport this project by becoming a sponsor. Your logo will show up here with a link to your website.\n\n\u003ca href=\"https://opencollective.com/visjs/sponsor/0/website\" target=\"_blank\"\u003e\u003cimg src=\"https://opencollective.com/visjs/sponsor/0/avatar.svg\"\u003e\u003c/a\u003e\n\u003ca href=\"https://opencollective.com/visjs/sponsor/1/website\" target=\"_blank\"\u003e\u003cimg src=\"https://opencollective.com/visjs/sponsor/1/avatar.svg\"\u003e\u003c/a\u003e\n\u003ca href=\"https://opencollective.com/visjs/sponsor/2/website\" target=\"_blank\"\u003e\u003cimg src=\"https://opencollective.com/visjs/sponsor/2/avatar.svg\"\u003e\u003c/a\u003e\n\u003ca href=\"https://opencollective.com/visjs/sponsor/3/website\" target=\"_blank\"\u003e\u003cimg src=\"https://opencollective.com/visjs/sponsor/3/avatar.svg\"\u003e\u003c/a\u003e\n\u003ca href=\"https://opencollective.com/visjs/sponsor/4/website\" target=\"_blank\"\u003e\u003cimg src=\"https://opencollective.com/visjs/sponsor/4/avatar.svg\"\u003e\u003c/a\u003e\n\u003ca href=\"https://opencollective.com/visjs/sponsor/5/website\" target=\"_blank\"\u003e\u003cimg src=\"https://opencollective.com/visjs/sponsor/5/avatar.svg\"\u003e\u003c/a\u003e\n\u003ca href=\"https://opencollective.com/visjs/sponsor/6/website\" target=\"_blank\"\u003e\u003cimg src=\"https://opencollective.com/visjs/sponsor/6/avatar.svg\"\u003e\u003c/a\u003e\n\u003ca href=\"https://opencollective.com/visjs/sponsor/7/website\" target=\"_blank\"\u003e\u003cimg src=\"https://opencollective.com/visjs/sponsor/7/avatar.svg\"\u003e\u003c/a\u003e\n\u003ca href=\"https://opencollective.com/visjs/sponsor/8/website\" target=\"_blank\"\u003e\u003cimg src=\"https://opencollective.com/visjs/sponsor/8/avatar.svg\"\u003e\u003c/a\u003e\n\u003ca href=\"https://opencollective.com/visjs/sponsor/9/website\" target=\"_blank\"\u003e\u003cimg src=\"https://opencollective.com/visjs/sponsor/9/avatar.svg\"\u003e\u003c/a\u003e\n\n## License\n\nCopyright (c) 2014-2017 Almende B.V. and contributors\nCopyright (c) 2017-2019 vis.js contributors\n\nThis work is dual-licensed under [Apache-2.0](./LICENSE.Apache-2.0.txt) and [MIT](./LICENSE.MIT.txt).\nYou can choose between one of them if you use this work.\n\n`SPDX-License-Identifier: Apache-2.0 OR MIT`\n","funding_links":["https://opencollective.com/visjs"],"categories":["JavaScript","JS Chart Libraries","UI Components","Libraries"],"sub_categories":["Timeline","Documentation \u0026 Help"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvisjs%2Fvis-timeline","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvisjs%2Fvis-timeline","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvisjs%2Fvis-timeline/lists"}