{"id":20811936,"url":"https://github.com/libercosoft/mainstack-test-server","last_synced_at":"2025-10-20T09:14:11.209Z","repository":{"id":211103416,"uuid":"728096269","full_name":"LIBERCOSOFT/mainstack-test-server","owner":"LIBERCOSOFT","description":"A simple RESTful API to create and manage products in a store with users authentication.","archived":false,"fork":false,"pushed_at":"2023-12-08T21:51:25.000Z","size":101,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-18T14:49:39.566Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/LIBERCOSOFT.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-12-06T08:13:10.000Z","updated_at":"2023-12-08T21:29:07.000Z","dependencies_parsed_at":"2024-11-17T20:49:28.419Z","dependency_job_id":"b3287952-ca0c-462a-a416-1338a8154f5f","html_url":"https://github.com/LIBERCOSOFT/mainstack-test-server","commit_stats":null,"previous_names":["libercosoft/mainstack-test-server"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LIBERCOSOFT%2Fmainstack-test-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LIBERCOSOFT%2Fmainstack-test-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LIBERCOSOFT%2Fmainstack-test-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LIBERCOSOFT%2Fmainstack-test-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/LIBERCOSOFT","download_url":"https://codeload.github.com/LIBERCOSOFT/mainstack-test-server/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243158971,"owners_count":20245669,"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-11-17T20:49:22.120Z","updated_at":"2025-10-20T09:14:06.175Z","avatar_url":"https://github.com/LIBERCOSOFT.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 📗 Table of Contents\n\n- [📗 Table of Contents](#-table-of-contents)\n- [📖 Server ](#-server-)\n  - [🛠 Built With ](#-built-with-)\n    - [Tech Stack ](#tech-stack-)\n    - [Key Features ](#key-features-)\n  - [🚀 Live Demo ](#-live-demo-)\n  - [💻 Getting Started ](#-getting-started-)\n    - [Prerequisites](#prerequisites)\n    - [Install \\\u0026 Setup](#install--setup)\n  - [👥 Authors ](#-authors-)\n  - [🔭 Future Features ](#-future-features-)\n  - [🙏 Acknowledgments ](#-acknowledgments-)\n\n\u003c!-- PROJECT DESCRIPTION --\u003e\n\n# 📖 Server \u003ca name=\"about-project\"\u003e\u003c/a\u003e\n\n**Server** is a simple CRUD (Create, Read, Update, Delete) application that manages the product in a store coupled with user authentication.\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\u003eServer\u003c/summary\u003e\n  \u003cul\u003e\n    \u003cli\u003e\u003ca href=\"https://nodejs.org/en\"\u003eNodeJS\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"https://www.typescriptlang.org\"\u003eTypescript\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"https://expressjs.com\"\u003eExpressJS\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"https://www.mongodb.com/atlas/database\"\u003eMongoDB\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"https://mongoosejs.com\"\u003eMongoose\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"https://www.docker.com\"\u003eDocker\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- **Persist a new product**\n- **Retrieve all products**\n- **Delete a saved product**\n- **Retrieve one product**\n- **Create new user**\n- **Authenticate a saved user**\n- **Logout a saved user**\n  \n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n## 🚀 Live Demo \u003ca name=\"live-demo\"\u003e\u003c/a\u003e\n\n[Live Demo Link](https://mainstack-test-server.onrender.com)\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n## 💻 Getting Started \u003ca name=\"getting-started\"\u003e\u003c/a\u003e\n\n\u003e To start and run this project with npm\n```\nnpm install\n```\n```\nnpm run server\n```\n```\nvisit http://localhost:5050\n```\n\n\u003e To start and run this project with docker\n- Build a docker image first, use this command:\n```\ndocker build -t mainstack-server .\n```\n- Run your docker container with this command:\n```\ndocker run -p 5050:5050 -d mainstack-server\n```\n- Check your container logs with the container id you got from the above command with this command:\n```\nsudo docker logs 'container-id'\n```\n- Visit the server below:\n```\nhttp://localhost:5050\n```\n\nTo get a local copy up and running, follow these steps.\n\n### Prerequisites\n\n- IDE / Editor\n- Git \n- NodeJS\n\n\n### Install \u0026 Setup\n\nTo setup and install this sample ROR Blog project, follow the below steps:\n- Clone this project by the command: \n\n```\n$ git clone hhttps://github.com/LIBERCOSOFT/mainstack-test-server\n```\n\n- Then switch to the project folder by the below query:\n\n```\n$ cd transport_system_server\n```\n- Create and fill a '.env' file using the .env.example\n  \n- Install npm dependencies with the command below:\n```\n$ npm install\n```\n\n- Start the development server with the command below:\n```\n$ npm run server\n```\n\n\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## 👥 Authors \u003ca name=\"authors\"\u003e\u003c/a\u003e\n\n👤 **Kolapo Precious Akinrinlola**\n\n- GitHub: [LIBERCOSOFT](https://github.com/LIBERCOSOFT)\n- Twitter: [@Gerfieldt](https://twitter.com/Gerfieldt)\n- LinkedIn: [Kolapo Akinrinlola](https://linkedin.com/in/kolapo-akinrinlola)\n\n\u003c!-- FUTURE FEATURES --\u003e\n\n## 🔭 Future Features \u003ca name=\"future-features\"\u003e\u003c/a\u003e\n- [ ] **Add an accounting feature to calculate cost of all products**\n- [ ] **Add an inventory functionality to add and remove from number of a product's stock**\n\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\n- [Mainstack](https://www.mainstack.co)\n\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flibercosoft%2Fmainstack-test-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flibercosoft%2Fmainstack-test-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flibercosoft%2Fmainstack-test-server/lists"}