{"id":13881003,"url":"https://github.com/harryho/react-crm","last_synced_at":"2025-03-17T06:02:16.558Z","repository":{"id":22554938,"uuid":"96674103","full_name":"harryho/react-crm","owner":"harryho","description":"A reusable CRM project for real-world business based on React 16, Redux \u0026 Material-UI 4","archived":false,"fork":false,"pushed_at":"2024-11-02T13:51:16.000Z","size":3985,"stargazers_count":491,"open_issues_count":20,"forks_count":211,"subscribers_count":29,"default_branch":"master","last_synced_at":"2025-03-08T08:31:07.174Z","etag":null,"topics":["material-ui","react","react-redux","real-world","storybook","thunk","typescript"],"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/harryho.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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}},"created_at":"2017-07-09T09:28:34.000Z","updated_at":"2025-02-19T12:45:55.000Z","dependencies_parsed_at":"2024-11-29T22:32:58.075Z","dependency_job_id":null,"html_url":"https://github.com/harryho/react-crm","commit_stats":{"total_commits":67,"total_committers":6,"mean_commits":"11.166666666666666","dds":"0.14925373134328357","last_synced_commit":"7f4c61c54fe4a67b4795119c5f4cfb28b80c8108"},"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/harryho%2Freact-crm","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/harryho%2Freact-crm/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/harryho%2Freact-crm/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/harryho%2Freact-crm/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/harryho","download_url":"https://codeload.github.com/harryho/react-crm/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243982140,"owners_count":20378605,"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":["material-ui","react","react-redux","real-world","storybook","thunk","typescript"],"created_at":"2024-08-06T08:03:46.115Z","updated_at":"2025-03-17T06:02:16.491Z","avatar_url":"https://github.com/harryho.png","language":"TypeScript","funding_links":[],"categories":["TypeScript"],"sub_categories":[],"readme":"## NOTICE: New React demo repo is available [here](https://github.com/harryho/react-demo). This repo is ___ARCHIVED___.\n\n### React Redux CRM\n\n\u003e A reusable CRM project for real-world business based on React 16, React-Redux \u0026 Material-UI 4\n\nThis is the very first version, feel free to use for any app. Contributions are always welcome!\n\nThe goal of this starter project is to create reusable project for real-world business. To achieve this target, we need a solution which should include simple authentication process, restful API with token support and simple but elegant UI design.\n\n### Features\n\n- This project is built on the top of React/Redux.\n- The UI component are mainly built on Material-UI.\n- This project uses Redux-Thunk to support back-end API.\n- The backend API is just readonly dump service.\n- Use Formik to manage the form submission\n- Integrate with storybook for react.\n- The project is built on TypeScript 3.x\n- ~~Use Formsy to manage form submission~~\n- ~~To simulate real-world business, this starter project chooses Json-Server as fake Restful API. (You can simple replace it with your own API)~~\n\n### Live Demo\n\n[Demo](https://react-app-demo.harryho.org) The demo is just a proof of concept. It doesn't have back-end API and all features of master branch.\n\n### Screenshots\n\n![Screenshot1](screenshots/screenshot-1.jpg)\n\n![Screenshot2](screenshots/screenshot-1.1.jpg)\n\n![Screenshot3](screenshots/screenshot-3.1.jpg)\n\n\u003c!-- ![Screenshot4](screenshots/screenshot-4.jpg) --\u003e\n\n----\n\nStorybook\n  \n![Screenshot4](screenshots/screenshot-6.jpg)\n\n\n## Build Setup\n\n```bash\n# Clone project\ngit clone https://github.com/harryho/react-crm.git\n\n\n# install the packages with npm\ncd react-crm\nnpm install\n\n# start the server with hot reload at localhost:4000\nnpm start\n# or yarn\nyarn start\n\n# Storybook\n## Start storybook\nnpm run storybook\n## Build storybook\nnpm run build-storybook\n\n## build for production\nnpm run build\n\n```\n\n\n\n## Docker \n\n```bash\n## Run / Test release without building new image\nnpm run build\n\n# Launch nginx image to test latest release\ndocker pull nginx:alpine\ndocker run -p 8080:80 -v \\\n    \u003cyour_absolute_path\u003e/dist:/usr/share/nginx/html nginx:alpine\n\n\n# Build release image\ndocker build . -t  rc-prd:2.0\n\n# Launch the development image in the background\ndocker run -d --publish 8080:80  --name rc2 rc-prd:2.0\n\n# Check the log\ndocker logs rc2  -f\n```\n\n## Welcome to fork or clone\n\nFor detailed explanation on how things work, checkout following links please.\n\n- [React](https://facebook.github.io/react/)\n- [Redux](http://redux.js.org/)\n- [Material-UI](http://www.material-ui.com/)\n\n### Alternatives\n\nThere are another two similar projects respectively built on the Vue.js and Angular. If you have interests in those technical stacks. You can find and clone those repositories below.\n\n- [Ng-MD-App](https://github.com/harryho/ng-md-app.git).\n- [Ng4Crm](https://github.com/harryho/ng4crm.git). (It is no longer maintained with latest Angular)\n- [Vue-Crm](https://github.com/harryho/vue-crm.git).\n\n### Change log\n\n- May 2020 -  Merge the branch rctsx to master\n\n  After the merge, the whole project moved to new technical stack - TypeScript 3. Also, the Material-UI is upgraded to 4.x version. Nodejs 12.x is recommended.\n\n\n- Dec 2018 - Rebase demo branch to master\n\n  New master doesn't rely on Json-Server as fake API. It will only have Readonly fake API. It means any new or updated data will be stored to any physical file. All test data will be rolled back after system restart.\n\n- May 2018 -  Create an archived branch json-server\n\n  This branch was the master which used Json-Server as fake API. Considering the hiccup of setting Json-Server up and maintenance, it will be replaced by fake service ( Readonly fake API). You still can find clone this branch by branch name **json-server**, but it will be no longer updated. It is an archived branch.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fharryho%2Freact-crm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fharryho%2Freact-crm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fharryho%2Freact-crm/lists"}