{"id":17562064,"url":"https://github.com/kidd254/hello_react_front_end","last_synced_at":"2025-06-20T06:07:34.223Z","repository":{"id":204849377,"uuid":"712574419","full_name":"Kidd254/Hello_react_front_end","owner":"Kidd254","description":null,"archived":false,"fork":false,"pushed_at":"2023-11-01T14:32:01.000Z","size":601,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"dev","last_synced_at":"2025-06-20T06:07:17.557Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","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/Kidd254.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-10-31T18:31:45.000Z","updated_at":"2023-10-31T19:41:05.000Z","dependencies_parsed_at":null,"dependency_job_id":"33653044-78b7-4428-a485-615be94f9942","html_url":"https://github.com/Kidd254/Hello_react_front_end","commit_stats":null,"previous_names":["kidd254/hello_react_front_end"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Kidd254/Hello_react_front_end","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kidd254%2FHello_react_front_end","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kidd254%2FHello_react_front_end/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kidd254%2FHello_react_front_end/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kidd254%2FHello_react_front_end/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Kidd254","download_url":"https://codeload.github.com/Kidd254/Hello_react_front_end/tar.gz/refs/heads/dev","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kidd254%2FHello_react_front_end/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260891171,"owners_count":23077912,"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":[],"created_at":"2024-10-21T12:25:21.391Z","updated_at":"2025-06-20T06:07:29.210Z","avatar_url":"https://github.com/Kidd254.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ca name=\"readme-top\"\u003e\u003c/a\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003ch1\u003e\u003cb\u003eHello React Frontend\u003c/b\u003e\u003c/h1\u003e\n\u003c/div\u003e\n\n# 📗 Table of Contents\n\n- [📗 Table of Contents](#-table-of-contents)\n- [Hello React Frontend](#hello-react-frontend)\n  - [🛠 Built With ](#-built-with-)\n    - [Tech Stack ](#tech-stack-)\n    - [Key Features ](#key-features-)\n    - [Backend Project ](#backend-project--)\n  - [💻 Getting Started ](#-getting-started-)\n    - [Setup](#setup)\n    - [Prerequisites](#prerequisites)\n    - [Install](#install)\n    - [Usage](#usage)\n    - [Build](#build)\n  - [👥 Authors ](#-authors-)\n  - [🔭 Future Features ](#-future-features-)\n  - [🤝 Contributing ](#-contributing-)\n  - [⭐️ Show your support ](#️-show-your-support-)\n  - [🙏 Acknowledgments ](#-acknowledgments-)\n  - [📝 License ](#-license-)\n\n# Hello React Frontend\u003ca name=\"about-project\"\u003e\u003c/a\u003e\n\n**Hello React Frontend** is a simple ReactJS application that connects to a greetings API and displays a random greetings in the browser; it's built with Redux to manage the global state and React Router V6 to create all the application routes.\n\n## 🛠 Built With \u003ca name=\"built-with\"\u003e\u003c/a\u003e\n\n### Tech Stack \u003ca name=\"tech-stack\"\u003e\u003c/a\u003e\n\n\u003cdetails\u003e\n  \u003csummary\u003eClient\u003c/summary\u003e\n  \u003cul\u003e\n    \u003cli\u003e\u003ca href=\"https://es.react.dev\"\u003eReact Library\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"https://reactrouter.com/en/main\"\u003eReact Router\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"https://nodejs.org\"\u003eNode.js\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"https://create-react-app.dev\"\u003eCreate React App\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"https://stylelint.io/\"\u003eStylelint.io\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"https://eslint.org/\"\u003eESlint.org\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"https://redux-toolkit.js.org/\"\u003eRedux Toolkit\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"https://axios-http.com/docs/intro\"\u003eAxios\u003c/a\u003e\u003c/li\u003e\n  \u003c/ul\u003e\n\u003c/details\u003e\n\n### Key Features \u003ca name=\"key-features\"\u003e\u003c/a\u003e\n\n- **Using the ReactJS library**\n- **Using the ReactJS Router library**\n- **Using JSX syntax**\n- **SPA Approach**\n- **Using Redux Toolkit for a global state management**\n- **Fetch API**\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n---\n\n### Backend Project \u003ca name=\"backend-project\"\u003e\u003c/a\u003e\n\nThe backend project can be found in the following link: [Hello Rails Backend](https://github.com/Kidd254/Hello_Rails_Back_End/pull/1)\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n---\n\n## 💻 Getting Started \u003ca name=\"getting-started\"\u003e\u003c/a\u003e\n\nTo get a local copy up and running, follow these steps.\n\n### Setup\n\nClone this repository to your desired folder:\n\n```sh\n  git clone https://github.com/Kidd254/Hello_react_front_end.git\n```\n\n### Prerequisites\n\nIn order to install, modify and run this project, it is necessary to have the following applications installed:\n\n- **Git:** to manage the project versions of source code. [You can Download Git here](https://git-scm.com/)\n\n- **Nodejs and NPM:** to install and manage the project dependencies. [Nodejs and NPM installation guide](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm)\n\n- **A code editor** like Visual Studio Code (Recommended) or any other of your preference. It is necessary to open the project and add or modify the source code. [You can Download Visual Studio Code here](https://code.visualstudio.com/)\n\nIt is also important to have at least basic knowledge about ReactJS, JSX, HTML, CSS and Javascript languages so you will be able to understand and work with the code of the project.\n\n- [Learn the basics of HTML](https://developer.mozilla.org/en-US/docs/Web/HTML)\n- [Learn the basics of CSS](https://developer.mozilla.org/en-US/docs/Web/CSS)\n- [JavaScript basics](https://developer.mozilla.org/en-US/docs/Learn/Getting_started_with_the_web/JavaScript_basics)\n- [Javascript Arrays](https://developer.mozilla.org/es/docs/Web/JavaScript/Reference/Global_Objects/Array)\n- [Javascript Objects](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object)\n- [JavaScript modules](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules)\n- [ReactJS](https://react.dev/learn)\n- [JSX](https://react.dev/learn/writing-markup-with-jsx)\n- [Create React App](https://github.com/facebook/create-react-app)\n\n### Install\n\nInstall this project by running the next command into your project folder:\n\n```sh\n  npm install\n```\n\nAll the packages and libraries necessary for the project to work will be installed in a folder called /node_module. After finishing the installation of this project, you should verify that you have the [Hello Rails Backend project](https://github.com/NitBravoA92/hello-rails-back-end) installed so that this project can work as expected.\n\n### Usage\n\n**IMPORTANT NOTE: As specified above, to run this project you must have the [Hello Rails Backend project](https://github.com/NitBravoA92/hello-rails-back-end) project installed and running, since it contains the API that will be consuming in this project. Please do not run this project without first running the project mentioned previously.**\n\nIn the project directory, you can run:\n\n- `npm start`\n\nA message similar to this will be displayed in the console:\n![Confirm to use another port to run the App](\u003cCaptura desde 2023-10-24 20-28-02.png\u003e)\n\nWhen the above message appears, press the `Y` key to allow the server to run the application on another available port (usually port 3001).\n\nWhen everything is ready, this message should appear in the console:\n\n- `compiled successfully!`\n\nOpen the main URL: [http://localhost:3001](http://localhost:3001) to see it the app running in your browser.\n\nThe page will reload when you make changes.\n\nYou may also see any CSS and JS linters errors in the console running the following commands:\n\nCSS Linter\n\n```sh\n  npx stylelint \"**/*.{css,scss}\"\n```\n\nJavascript Linter\n\n```sh\n  npx eslint \"**/*.{js,jsx}\"\n```\n\n### Build\n\n- `npm run build`\n\nBuilds the app for production to the `build` folder.\\\nIt correctly bundles React in production mode and optimizes the build for the best performance.\n\nThe build is minified and the filenames include the hashes.\\\nYour app is ready to be deployed!\n\nSee the section about [deployment](https://facebook.github.io/create-react-app/docs/deployment) for more information.\n\n**Note**: Please only modify the components files and the CSS files. Do not modify configurations files of the project.\n\n## 👥 Authors \u003ca name=\"authors\"\u003e\u003c/a\u003e\n\n👤 **Lawrence Muema Kioko**\n\n- GitHub: [@githubhandle](https://github.com/Kidd254)\n- Twitter: [@twitterhandle](https://twitter.com/lawrenc98789206)\n- LinkedIn: [LinkedIn](https://www.linkedin.com/in/lawrence-muema-kioko)\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n## 🔭 Future Features \u003ca name=\"future-features\"\u003e\u003c/a\u003e\n\n- [ ] **Create the view: All Greetings list**\n- [ ] **Add custom CSS styles to the UI**\n- [ ] **Deploy the final version of the project and share Link Demo in the documentation**\n- [ ] **Create Unit tests using Jest and React testing library**\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n## 🤝 Contributing \u003ca name=\"contributing\"\u003e\u003c/a\u003e\n\nContributions, issues, suggestions and feature requests are welcome!\nFeel free to check the [issues page](../../issues/).\n\nTo do Contributions, please fork this repository, create a new branch and then create a Pull Request from your branch. You can find detailed description of this process in: [A Step by Step Guide to Making Your First GitHub Contribution by Brandon Morelli](https://codeburst.io/a-step-by-step-guide-to-making-your-first-github-contribution-5302260a2940)\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n## ⭐️ Show your support \u003ca name=\"support\"\u003e\u003c/a\u003e\n\nIf you liked this project, give me a \"Star\" (clicking the star button at the beginning of this page), share this repo with your developer community or make your contributions.\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n## 🙏 Acknowledgments \u003ca name=\"acknowledgements\"\u003e\u003c/a\u003e\n\nI would also like to thank my Microverse teammates for their support. They have supported me a lot in carrying out this project, giving me suggestions, good advice and solving my code doubts.\n\n## 📝 License \u003ca name=\"license\"\u003e\u003c/a\u003e\n\nThis project is [MIT](./LICENSE) licensed.\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\u003ca name=\"readme-top\"\u003e\u003c/a\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkidd254%2Fhello_react_front_end","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkidd254%2Fhello_react_front_end","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkidd254%2Fhello_react_front_end/lists"}