{"id":16359723,"url":"https://github.com/jmsv/simple-mern","last_synced_at":"2025-07-26T22:35:20.947Z","repository":{"id":48036974,"uuid":"206834607","full_name":"jmsv/simple-mern","owner":"jmsv","description":"the simplest MERN (MongoDB, Express, React and Node) setup","archived":false,"fork":false,"pushed_at":"2023-02-01T16:16:12.000Z","size":305,"stargazers_count":27,"open_issues_count":5,"forks_count":23,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-17T19:21:21.456Z","etag":null,"topics":["express","hacktoberfest","javascript","mern","mern-starters","mongodb","mongoose","node","nodejs","react","reactjs"],"latest_commit_sha":null,"homepage":"","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/jmsv.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":"2019-09-06T16:34:25.000Z","updated_at":"2024-11-25T08:33:05.000Z","dependencies_parsed_at":"2023-02-17T08:01:02.094Z","dependency_job_id":null,"html_url":"https://github.com/jmsv/simple-mern","commit_stats":null,"previous_names":[],"tags_count":0,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jmsv%2Fsimple-mern","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jmsv%2Fsimple-mern/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jmsv%2Fsimple-mern/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jmsv%2Fsimple-mern/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jmsv","download_url":"https://codeload.github.com/jmsv/simple-mern/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244717391,"owners_count":20498283,"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":["express","hacktoberfest","javascript","mern","mern-starters","mongodb","mongoose","node","nodejs","react","reactjs"],"created_at":"2024-10-11T02:09:30.656Z","updated_at":"2025-03-21T00:31:41.282Z","avatar_url":"https://github.com/jmsv.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\r\n  \u003cimg src=\"https://user-images.githubusercontent.com/14852491/64910580-cc163700-d70f-11e9-99ec-8c49095a8c3b.png\" /\u003e\r\n  \u003cbr/\u003e\r\n  the simplest MERN (MongoDB, Express, React and Node) setup\r\n\u003c/p\u003e\r\n\r\n## Why?\r\n\r\nWhile there are many MERN starters on the interwebs already, I've struggled to find a 'minimal viable' MERN app. Existing examples usually involve other libraries and tools such as Redux, React Router, Typescript, Docker etc. These are all great things, but add unnecessary complexity when you just want to start simple.\r\n\r\nThis MERN starter, `simple-mern` aims to be the minimum you need to get started with the stack.\r\n\r\n## Getting Started\r\n\r\n### Development\r\n\r\n1. Install MongoDB and run on default port `27017`\r\n2. `npm install` in both root directory and `client` directory\r\n3. `npm start` in both root directory and `client` directory\r\n4. Head to [localhost:3000](http://localhost:3000) to see the 'My Tasks' app\r\n\r\n### Production\r\n\r\n```bash\r\nnpm install\r\nnpm run build\r\nnpm run start:prod\r\n```\r\n\r\nThe production app will be running at [localhost:5000](http://localhost:5000/).\r\n\r\n## Extend `simple-mern`\r\n\r\nWhile this boilerplate was designed to be as minimal as possible, support for other tech could be added _in their own branches_.\r\n\r\n### Current Extensions\r\n\r\n- [`with-axios`](https://github.com/jmsv/simple-mern/tree/with-axios): Replaces Axios with fetch - [@leonlafa](https://github.com/leonlafa)\r\n- [`with-react-router`](https://github.com/jmsv/simple-mern/tree/with-react-router): Adds React Router - [@leonlafa](https://github.com/leonlafa)\r\n- [`with-material-ui`](https://github.com/jmsv/simple-mern/tree/with-material-ui): Adds Material UI - [@leonlafa](https://github.com/leonlafa)\r\n- [`with-docker`](https://github.com/jmsv/simple-mern/tree/with-docker): Adds Docker \u0026 Docker Compose - [@alejandrotoga02](https://github.com/alejandrotoga02)\r\n- [`with-redux`](https://github.com/jmsv/simple-mern/tree/with-redux): Adds Redux for state management - [@rahulSinha-01](https://github.com/rahulSinha-01)\r\n\r\n### Ideas for Future Extensions\r\n\r\n- Replace JavaScript with TypeScript\r\n- Multi-user setup with social auth (e.g. Google, Facebook etc. login using Passport)\r\n- [Redux](https://redux.js.org) or [MobX](https://mobx.js.org) global state management for tasks\r\n- Static site generator using [GatsbyJS](https://www.gatsbyjs.org/) or [Next.js](https://nextjs.org/)\r\n\r\nIf you'd like to add support for any of the above or something else, please open an [issue](https://github.com/jmsv/simple-mern/issues) letting me know, and I'll create a new branch to base the PR against.\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjmsv%2Fsimple-mern","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjmsv%2Fsimple-mern","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjmsv%2Fsimple-mern/lists"}