{"id":21057947,"url":"https://github.com/lilingxi01/ams-date-picker","last_synced_at":"2025-05-15T23:34:02.178Z","repository":{"id":37535563,"uuid":"491805406","full_name":"lilingxi01/ams-date-picker","owner":"lilingxi01","description":"(WIP) Ams Date Picker - A modern, magical, and unstyled date picker for React. We have your favorite Time Machine and Input Supercharge out-of-box.","archived":false,"fork":false,"pushed_at":"2023-02-17T01:55:35.000Z","size":1888,"stargazers_count":32,"open_issues_count":13,"forks_count":0,"subscribers_count":7,"default_branch":"main","last_synced_at":"2025-05-10T03:14:31.691Z","etag":null,"topics":["component","date","date-picker","date-selector","daylight-savings","modern","react"],"latest_commit_sha":null,"homepage":"https://ams.lingxi.li","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/lilingxi01.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-05-13T07:47:34.000Z","updated_at":"2024-10-23T20:26:59.000Z","dependencies_parsed_at":"2022-08-26T14:04:37.452Z","dependency_job_id":null,"html_url":"https://github.com/lilingxi01/ams-date-picker","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lilingxi01%2Fams-date-picker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lilingxi01%2Fams-date-picker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lilingxi01%2Fams-date-picker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lilingxi01%2Fams-date-picker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lilingxi01","download_url":"https://codeload.github.com/lilingxi01/ams-date-picker/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254442429,"owners_count":22071864,"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","date","date-picker","date-selector","daylight-savings","modern","react"],"created_at":"2024-11-19T17:05:53.200Z","updated_at":"2025-05-15T23:34:02.150Z","avatar_url":"https://github.com/lilingxi01.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"![AmsDatePicker Cover](https://imagedelivery.net/Dr98IMl5gQ9tPkFM5JRcng/d6bffcf4-bee4-4235-de19-b68a0be89800/HD)\n\n![WIP](https://img.shields.io/badge/Headless-0.0.5-blue.svg?style=flat-square) ![WIP](https://img.shields.io/badge/Styled-Work%20in%20progress-red.svg?style=flat-square)\n\n# Get Started\n\nAms Date Picker (in code known as `AmsDatePicker`) is a powerful date picker component for React. It not only provides a modern look of date/time picker, but also provides a bunch of powerful features to boost the user experience while inputting a date/time.\n\n# WIP ([Roadmap](https://github.com/lilingxi01/ams-date-picker/issues/2))\n\nThis project is still **in development**. It is not yet ready for use. We will release it as soon as it is ready. Stay tuned and check back soon!\n\n# Installation\n\nFor `npm` user:\n```bash\nnpm install @ams-js/headless\n```\n\nFor `yarn` user:\n```bash\nyarn add @ams-js/headless\n```\n\nFor `pnpm` user:\n```bash\npnpm add @ams-js/headless\n```\n\n# Usage\n\nFor now, we only have Input component available. In the future, we will have Date Selector component and more plugins, which will also be used within `\u003cDatePicker.Root\u003e`.\n\n### Single Date Input (Headless)\n\n```tsx\nimport * as DatePicker from '@ams-js/headless';\n\nexport const MyDatePicker = () =\u003e {\n  const [dateState, setDateState] = useState\u003cDate | null\u003e(null);\n  return (\n    \u003cDatePicker.Root\n      date={dateState}\n      onDateChange={setDateState}\n      onError={(error) =\u003e console.error(error)}\n      dateOptions={{ ... }} // You can customize as JavaScript Date options.\n    \u003e\n      \u003cDatePicker.Input\n        {/* Any \u003cinput\u003e prop is allowed */}\n      /\u003e\n    \u003c/DatePicker.Root\u003e\n  );\n};\n```\n\n### Range Date Input (Headless)\n\n```tsx\nimport * as DatePicker from '@ams-js/headless';\n\nexport const MyRangeDatePicker = () =\u003e {\n  const [firstDate, setFirstDate] = useState\u003cDate | null\u003e(null);\n  const [secondDate, setSecondDate] = useState\u003cDate | null\u003e(null);\n  return (\n    \u003cdiv\u003e\n      \u003cDatePicker.Root\n        date={firstDate}\n        onDateChange={setFirstDate}\n        onError={(error) =\u003e console.error(error)}\n        dateOptions={{ ... }} // You can customize as JavaScript Date options.\n      \u003e\n        \u003cDatePicker.Input\n          {/* Any \u003cinput\u003e prop is allowed */}\n        /\u003e\n      \u003c/DatePicker.Root\u003e\n      \u003cDatePicker.Root\n        date={secondDate}\n        baseDate={firstDate} // So all modifiers of the second date will be based on the first date.\n        onDateChange={setSecondDate}\n        onError={(error) =\u003e console.error(error)}\n        dateOptions={{ ... }} // You can customize as JavaScript Date options.\n      \u003e\n        \u003cDatePicker.Input\n          {/* Any \u003cinput\u003e prop is allowed */}\n        /\u003e\n      \u003c/DatePicker.Root\u003e\n    \u003c/div\u003e\n  );\n};\n```\n\n# Design Prototype\n\n![Date Picker Prototype](https://user-images.githubusercontent.com/36816148/169880375-a60d1198-dd6f-4add-ac62-b86d6cc41918.png)\n\n![Date Selector Prototype](https://user-images.githubusercontent.com/36816148/169880433-96701a89-691f-413f-b954-404882d28dbf.png)\n\n![Date Conflict Resolver](https://user-images.githubusercontent.com/36816148/169919720-1828b8d7-0862-4868-abb9-2a89a2170c33.png)\n\n![Date Picker User Manual](https://user-images.githubusercontent.com/36816148/170132516-99c20992-d004-4a4e-b420-b1cfa76e6ca7.png)\n\n![Dark Mode Support](https://user-images.githubusercontent.com/36816148/172277845-26b2d8be-733f-4c50-8655-f4496bcd2f7b.png)\n\n# FAQ\n\n## Why is this project called `AmsDatePicker`?\n\nThis project is called `AmsDatePicker` because it was born in Amherst, MA. The original group members are all coming from University of Massachusetts Amherst in [Indigo Development](https://github.com/mbucc/320-S22-Track2/wiki/Indigo).\n\n# Contributors ✨\n\n\u003c!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section --\u003e\n\u003c!-- prettier-ignore-start --\u003e\n\u003c!-- markdownlint-disable --\u003e\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://lingxi.li\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/36816148?v=4?s=100\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eLingxi Li\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"#design-lilingxi01\" title=\"Design\"\u003e🎨\u003c/a\u003e \u003ca href=\"https://github.com/lilingxi01/ams-date-picker/commits?author=lilingxi01\" title=\"Code\"\u003e💻\u003c/a\u003e \u003ca href=\"https://github.com/lilingxi01/ams-date-picker/commits?author=lilingxi01\" title=\"Tests\"\u003e⚠️\u003c/a\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://github.com/limbo-yan\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/46770483?v=4?s=100\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003elimbo-yan\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/lilingxi01/ams-date-picker/commits?author=limbo-yan\" title=\"Code\"\u003e💻\u003c/a\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n\u003c!-- markdownlint-restore --\u003e\n\u003c!-- prettier-ignore-end --\u003e\n\n\u003c!-- ALL-CONTRIBUTORS-LIST:END --\u003e\n\nThanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key))!\n\n# Credits\n\nIt was originated in project [here](https://github.com/mbucc/320-S22-Track2), but it was now separated and moved to here (keeping all old contributions from Git).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flilingxi01%2Fams-date-picker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flilingxi01%2Fams-date-picker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flilingxi01%2Fams-date-picker/lists"}