{"id":20048390,"url":"https://github.com/natasha-ct/mailbox-app","last_synced_at":"2025-10-24T09:58:19.258Z","repository":{"id":128702436,"uuid":"594364771","full_name":"NATASHA-ct/MAILBOX-APP","owner":"NATASHA-ct","description":"[MAILBOX] is a mail inbox fullstack application built using React.js and Node.js. The app allows users to view their email messages and the app marks the opened messages as read. The app implements an API layer to fetch and update message data stored in a database.","archived":false,"fork":false,"pushed_at":"2023-01-31T09:55:28.000Z","size":1591,"stargazers_count":4,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-10-13T15:12:31.003Z","etag":null,"topics":["api","api-documentation","full-stack","mern-stack","modules","mongodb","mongodb-atlas","mongoose","node-js","postman","reactjs"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/NATASHA-ct.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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-01-28T10:15:41.000Z","updated_at":"2023-02-10T05:16:23.000Z","dependencies_parsed_at":"2023-06-04T17:00:22.227Z","dependency_job_id":null,"html_url":"https://github.com/NATASHA-ct/MAILBOX-APP","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/NATASHA-ct/MAILBOX-APP","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NATASHA-ct%2FMAILBOX-APP","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NATASHA-ct%2FMAILBOX-APP/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NATASHA-ct%2FMAILBOX-APP/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NATASHA-ct%2FMAILBOX-APP/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/NATASHA-ct","download_url":"https://codeload.github.com/NATASHA-ct/MAILBOX-APP/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NATASHA-ct%2FMAILBOX-APP/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":280776478,"owners_count":26388950,"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-10-24T02:00:06.418Z","response_time":73,"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":["api","api-documentation","full-stack","mern-stack","modules","mongodb","mongodb-atlas","mongoose","node-js","postman","reactjs"],"created_at":"2024-11-13T11:43:29.721Z","updated_at":"2025-10-24T09:58:19.227Z","avatar_url":"https://github.com/NATASHA-ct.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 📖 [MAILBOX APP] \u003ca name=\"about-project\"\u003e\u003c/a\u003e\n\n\u003e\n\n**[MAILBOX]** is a mail inbox fullstack application built using React.js and Node.js. The app allows users to view their email messages and the app marks the opened messages as read. The app implements an API layer to fetch and update message data stored in a database. The top bar of the app indicates the number of unread messages and the name of the user. The app is styled using CSS. The app uses a predefined user and only shows messages for that user and to that user.\n\n## 🛠 Built With \u003ca name=\"built-with\"\u003e\u003c/a\u003e\n- MongoDB\n- Expres.js\n- React\n- Node.js\n\n\n### Key Features \u003ca name=\"key-features\"\u003e\u003c/a\u003e\n\nfeatures:\n- Node provides the backend environment for this application\n- Express middleware is used to handle requests, routes\n- Mongoose schemas to model the application data\n- React for displaying UI components\n\n1. Login\n2. Homepage\n3. inbox page\n4. Message page\n5. Differentiation of read and unread messages\n6. Text on homepage telling the user the number of unread messages they have\n\n\n\n## API DOCUMENTATION\n\n[https://documenter.getpostman.com/view/25553859/2s935isRVZ](https://documenter.getpostman.com/view/25553859/2s935isRVZ)\n\n## Getting Started \n\n### Prerequisites\n\nIn order to run this project you need:\n\n- Node\n\n- Express\n\n- Mongoose\n\n- React\n\n- Webpack\n\n- MongoDB\n\n\n### Setup\n\nClone this repository to your desired folder:\n\n```\n$ git clone https://github.com/NATASHA-ct/MAILBOX-APP.git\n  \n```\n\n\n### Install\n\nInstall this project with:\n\n```\n // go to client folder(frontend)\n$ yarn # or npm i    // npm install packages\n\n // go to server folder(backend)\n$ yarn # or npm i    // npm install packages\n\n```\n\n\n### Usage\n\nTo run the project, execute the following command:\n\n```\nIn your code editor open 2 terminals one for frontend and one for backend\n\n#### Run the backend\n$ cd backend\n$ npm run dev\n\n#### Run the frontend\n$ cd frontend\n\n$ npm run start  \n```\n\n\n\n\n### Deployment\n\nTo be deployed\n```\nusing render\n\n```\n\u003c!--\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\u003c AUTHORS --\u003e\n\n## 👥 Author \u003ca name=\"authors\"\u003e\u003c/a\u003e\n\n👤 **NATASHA TATENDA CHIROMBE**\n\n- GitHub: [@NATASHA-ct]((https://github.com/NATASHA-ct)\n- Twitter: [@NatashaChirombe]\n- LinkedIn: [Natasha Chirombe](linkedin.com/in/natasha-chirombe-1531aa17b)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnatasha-ct%2Fmailbox-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnatasha-ct%2Fmailbox-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnatasha-ct%2Fmailbox-app/lists"}