{"id":21684373,"url":"https://github.com/knovator/data-import-widget","last_synced_at":"2026-04-09T07:02:08.679Z","repository":{"id":45134495,"uuid":"445041834","full_name":"knovator/data-import-widget","owner":"knovator","description":"Widget built to communicate easily with `@knovator/data-import` application.","archived":false,"fork":false,"pushed_at":"2022-08-03T09:43:51.000Z","size":841,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-20T11:31:59.309Z","etag":null,"topics":["data-import","database","excel-import","spreadsheet","widget"],"latest_commit_sha":null,"homepage":"","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/knovator.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}},"created_at":"2022-01-06T04:38:36.000Z","updated_at":"2022-08-03T09:38:04.000Z","dependencies_parsed_at":"2022-08-24T02:11:14.795Z","dependency_job_id":null,"html_url":"https://github.com/knovator/data-import-widget","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/knovator/data-import-widget","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/knovator%2Fdata-import-widget","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/knovator%2Fdata-import-widget/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/knovator%2Fdata-import-widget/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/knovator%2Fdata-import-widget/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/knovator","download_url":"https://codeload.github.com/knovator/data-import-widget/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/knovator%2Fdata-import-widget/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267621597,"owners_count":24116900,"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-07-29T02:00:12.549Z","response_time":2574,"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":["data-import","database","excel-import","spreadsheet","widget"],"created_at":"2024-11-25T16:15:30.363Z","updated_at":"2025-12-30T21:56:24.918Z","avatar_url":"https://github.com/knovator.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv id=\"top\"\u003e\u003c/div\u003e\n\n![npm](https://img.shields.io/npm/v/@knovator/data-import-widget?style=flat-square) ![npm](https://img.shields.io/npm/dt/@knovator/data-import-widget?style=flat-square) ![npm bundle size](https://img.shields.io/bundlephobia/minzip/@knovator/data-import-widget?style=flat-square)\n\n\u003c!-- PROJECT LOGO --\u003e\n\u003cbr /\u003e\n\u003cdiv align=\"center\"\u003e\n\n\u003ch3 align=\"center\"\u003e@knovator/data-import-widget\u003c/h3\u003e\n\n  \u003cp align=\"center\"\u003e\n    `@knovator/data-import-widget` is built to communicate easily with `@knovator/data-import` application.\n    \u003cbr /\u003e\n    \u003ca href=\"https://github.com/knovator/data-import-widget\"\u003e\u003cstrong\u003eExplore the docs »\u003c/strong\u003e\u003c/a\u003e\n    \u003cbr /\u003e\n    \u003cbr /\u003e\n    \u003ca href=\"https://github.com/knovator/data-import-widget\"\u003eView Demo\u003c/a\u003e\n    ·\n    \u003ca href=\"https://github.com/knovator/data-import-widget/issues\"\u003eReport Bug\u003c/a\u003e\n    ·\n    \u003ca href=\"https://github.com/knovator/data-import-widget/issues\"\u003eRequest Feature\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n\n\n\u003c!-- TABLE OF CONTENTS --\u003e\n\u003cdetails\u003e\n  \u003csummary\u003eTable of Contents\u003c/summary\u003e\n  \u003col\u003e\n    \u003cli\u003e\n      \u003ca href=\"#about-the-project\"\u003eAbout The Project\u003c/a\u003e\n      \u003cul\u003e\n        \u003cli\u003e\u003ca href=\"#built-with\"\u003eBuilt With\u003c/a\u003e\u003c/li\u003e\n      \u003c/ul\u003e\n    \u003c/li\u003e\n    \u003cli\u003e\n      \u003ca href=\"#getting-started\"\u003eGetting Started\u003c/a\u003e\n      \u003cul\u003e\n        \u003cli\u003e\u003ca href=\"#prerequisites\"\u003ePrerequisites\u003c/a\u003e\u003c/li\u003e\n        \u003cli\u003e\u003ca href=\"#installation\"\u003eInstallation\u003c/a\u003e\u003c/li\u003e\n      \u003c/ul\u003e\n    \u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#usage\"\u003eUsage\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#contributing\"\u003eContributing\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#license\"\u003eLicense\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#contact\"\u003eContact\u003c/a\u003e\u003c/li\u003e\n  \u003c/ol\u003e\n\u003c/details\u003e\n\n\n\n\u003c!-- ABOUT THE PROJECT --\u003e\n## About The Project\n\nIt provides user side of part for already generated templates and allow user to import data into their database system. For more info about backend application, please visit [knovator/data-import](https://github.com/knovator/data-import).\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n### Built With\n\n* [ReactJS](https://reactjs.org/)\n* [TailwindCSS](https://tailwindcss.com/)\n* [Typescript](https://www.typescriptlang.org/)\n* [Babel](https://babeljs.io/)\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n\n\u003c!-- GETTING STARTED --\u003e\n## Getting Started\n\nTo use `data-import-widget` in your application you need ReactJS or NextJS application ready.\n\n### Prerequisites\n\n- Create empty react application if not have already.\n  ```sh\n  npx create-react-app my-app\n  cd my-app\n  npm start\n  ```\n- Your [Data Import](https://github.com/knovator/data-import) project should be running and also there should be atleast one template to get started.\n\n### Installation\n\n1. Install **Data Import Widget**, by running following command inside your applicaiton.\n    ```\n    npm i @knovator/data-import-widget\n    ```\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n\n\u003c!-- USAGE EXAMPLES --\u003e\n## Usage\n\n- Using `data-import-widget` is easy to use, it listens to click event on it's children and based on that it will open modal for importing files.\n  ```jsx\n  import DataImport from '@knovator/data-import-widget'\n\n  function App() {\n    \n    return (\u003cdiv\u003e\n        \u003cDataImport \u003e\n          \u003cbutton\u003e Import data \u003c/button\u003e\n        \u003c/DataImport\u003e\n      \u003c/div\u003e)\n  }\n  ```\n  ![Template Selection](modal-1.png)\n  ![File Upload](modal-2.png)\n- Here it will load templates from your provided project. Once you choose a template it will show the option to upload the file(`.xlsx`, `.csv`). \n- After uploading a file via the Import button, the Import Data modal will be closed. In the background, it will do validation and transformation based on columns of the selected template. \n- After all that, it will call the callback URL from the template with extracted data.\n- Loading thousands of data at one time is not good for the server, it'll unnecessarily use CPU  and Memory. To reduce such kind of accident it will split data into chunks of 1000 and then it will call a callback API.\n  | Props               | Required ? | Type       | Use Case                                                     |\n  | ------------------- | ---------- | ---------- | ------------------------------------------------------------ |\n  | `onNotify`          | false      | `function` | `{type: 'success' | 'error',payload: success message or error stack}` |\n  | `getAdditionalInfo` | false      | `function` | it can be used if you need to pass addition data to the proccess file |\n  | `projectCode`       | true       | `string`   | You need to pass your project code to load templates.        |\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n\n\n\u003c!-- CONTRIBUTING --\u003e\n## Contributing\n\nContributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.\n\nIf you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag \"enhancement\".\nDon't forget to give the project a star! Thanks again!\n\n1. Fork the Project\n2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the Branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n\n\u003c!-- LICENSE --\u003e\n## License\n\nDistributed under the MIT License. See `LICENSE.txt` for more information.\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n\u003c!-- CONTACT --\u003e\n## Contact\n\nKnovator Technologies\n- Twitter [@knovator](https://twitter.com/knovator)\n- Web [https://knovator.com/](https://knovator.com/)\n\nProject Link: [https://github.com/knovator/data-import-widget](https://github.com/knovator/data-import-widget)\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fknovator%2Fdata-import-widget","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fknovator%2Fdata-import-widget","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fknovator%2Fdata-import-widget/lists"}