{"id":14957547,"url":"https://github.com/amazingandyyy/mern","last_synced_at":"2025-04-12T17:41:46.452Z","repository":{"id":40621314,"uuid":"77355274","full_name":"amazingandyyy/mern","owner":"amazingandyyy","description":"🌐  MERN stack 2.0 - MongoDB, Express, React/Redux, Node","archived":false,"fork":false,"pushed_at":"2024-07-15T17:47:39.000Z","size":36103,"stargazers_count":533,"open_issues_count":8,"forks_count":295,"subscribers_count":17,"default_branch":"main","last_synced_at":"2025-04-03T19:14:21.973Z","etag":null,"topics":["boilerplate","boilerplate-template","express","expressjs","fullstack","jwt","mern","mern-boilerplate","mern-stack","mongodb","nodejs","react","redux","starter-kit"],"latest_commit_sha":null,"homepage":"https://amazingandyyy.com/mern","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/amazingandyyy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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":"2016-12-26T03:28:04.000Z","updated_at":"2025-03-20T13:30:04.000Z","dependencies_parsed_at":"2024-12-06T11:04:16.851Z","dependency_job_id":"e5f6489b-1572-411f-9ecd-9357b815c9fd","html_url":"https://github.com/amazingandyyy/mern","commit_stats":{"total_commits":172,"total_committers":9,"mean_commits":19.11111111111111,"dds":"0.15697674418604646","last_synced_commit":"ab464d009dae41d7b5468e02ed3e68b238ca96d7"},"previous_names":[],"tags_count":6,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amazingandyyy%2Fmern","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amazingandyyy%2Fmern/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amazingandyyy%2Fmern/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amazingandyyy%2Fmern/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/amazingandyyy","download_url":"https://codeload.github.com/amazingandyyy/mern/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248608028,"owners_count":21132650,"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":["boilerplate","boilerplate-template","express","expressjs","fullstack","jwt","mern","mern-boilerplate","mern-stack","mongodb","nodejs","react","redux","starter-kit"],"created_at":"2024-09-24T13:15:07.864Z","updated_at":"2025-04-12T17:41:46.422Z","avatar_url":"https://github.com/amazingandyyy.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\n🌐 MERN Stack\n\u003c/h1\u003e\n\u003cp align=\"center\"\u003e\nMongoDB, Expressjs, React/Redux, Nodejs\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n   \u003ca href=\"https://github.com/amazingandyyy/mern/blob/master/LICENSE\"\u003e\n      \u003cimg src=\"https://img.shields.io/badge/License-MIT-green.svg\" /\u003e\n   \u003c/a\u003e\n   \u003ca href=\"https://circleci.com/gh/amazingandyyy/mern\"\u003e\n      \u003cimg src=\"https://circleci.com/gh/amazingandyyy/mern.svg?style=svg\" /\u003e\n   \u003c/a\u003e\n\u003c/p\u003e\n\n\u003e MERN is a fullstack implementation in MongoDB, Expressjs, React/Redux, Nodejs.\n\nMERN stack is the idea of using Javascript/Node for fullstack web development.\n\n## clone or download\n```terminal\n$ git clone https://github.com/amazingandyyy/mern.git\n$ yarn # or npm i\n```\n\n## project structure\n```terminal\nLICENSE\npackage.json\nserver/\n   package.json\n   .env (to create .env, check [prepare your secret session])\nclient/\n   package.json\n...\n```\n\n# Usage (run fullstack app on your machine)\n\n## Prerequisites\n- [MongoDB](https://gist.github.com/nrollr/9f523ae17ecdbb50311980503409aeb3)\n- [Node](https://nodejs.org/en/download/) ^10.0.0\n- [npm](https://nodejs.org/en/download/package-manager/)\n\nnotice, you need client and server runs concurrently in different terminal session, in order to make them talk to each other\n\n## Client-side usage(PORT: 3000)\n```terminal\n$ cd client          // go to client folder\n$ yarn # or npm i    // npm install packages\n$ npm run dev        // run it locally\n\n// deployment for client app\n$ npm run build // this will compile the react code using webpack and generate a folder called docs in the root level\n$ npm run start // this will run the files in docs, this behavior is exactly the same how gh-pages will run your static site\n```\n\n## Server-side usage(PORT: 8000)\n\n### Prepare your secret\n\nrun the script at the first level:\n\n(You need to add a JWT_SECRET in .env to connect to MongoDB)\n\n```terminal\n// in the root level\n$ cd server\n$ echo \"JWT_SECRET=YOUR_JWT_SECRET\" \u003e\u003e src/.env\n```\n\n### Start\n\n```terminal\n$ cd server   // go to server folder\n$ npm i       // npm install packages\n$ npm run dev // run it locally\n$ npm run build // this will build the server code to es5 js codes and generate a dist file\n```\n\n## Deploy Server to [Heroku](https://dashboard.heroku.com/)\n```terminal\n$ npm i -g heroku\n$ heroku login\n...\n$ heroku create\n$ npm run heroku:add \u003cyour-super-amazing-heroku-app\u003e\n// remember to run this command in the root level, not the server level, so if you follow the documentation along, you may need to do `cd ..`\n$ pwd\n/Users/\u003cyour-name\u003e/mern\n$ npm run deploy:heroku\n```\n\n### After creating heroku\n\nif using webpack:\nremember to update the file of [client/webpack.prod.js](https://github.com/amazingandyyy/mern/blob/master/client/webpack.prod.js)\n```javascript\n 'API_URI': JSON.stringify('https://your-super-amazing-heroku-app.herokuapp.com')\n```\nif using parcel\nremember to update the file of [client/.env.production](https://github.com/amazingandyyy/mern/blob/master/client/.env.production.js)\n```\n REACT_APP_API_URI=https://your-super-amazing-heroku-app.herokuapp.com\n```\n# Dependencies(tech-stacks)\nClient-side | Server-side\n--- | ---\naxios: ^0.15.3 | bcrypt-nodejs: ^0.0.3\nbabel-preset-stage-1: ^6.1.18|body-parser: ^1.15.2\nlodash: ^3.10.1 | cors: ^2.8.1\nreact: ^16.2.0 | dotenv: ^2.0.0\nreact-dom: ^16.2.0 | express: ^4.14.0\nreact-redux: ^4.0.0 | jwt-simple: ^0.5.1\nreact-router-dom: ^4.2.2 | mongoose: ^4.7.4\nredux: ^3.7.2 | morgan: ^1.7.0\nredux-thunk: ^2.1.0 |\n\n# Screenshots of this project\n\nUser visit public and Home page\n![User visit public and Home page](http://i.imgur.com/ORCGHHY.png)\n\nUser can sign in or sign up\n![User can sign in or sign up](http://i.imgur.com/rrmbU5I.png)\n\nAfter signing in user can go to account route and make request to token-protected API endpoint\n![After signing in user can go to account route](http://i.imgur.com/FzLB51u.png)\n\n## Standard\n\n[![JavaScript Style Guide](https://cdn.rawgit.com/standard/standard/master/badge.svg)](https://github.com/standard/standard)\n\n## BUGs or comments\n\n[Create new Issues](https://github.com/amazingandyyy/mern/issues) (preferred)\n\nEmail Me: amazingandyyy@gmail.com (welcome, say hi)\n\n## Author\n[Amazingandyyy](https://amazingandyyy.com)\n\nI recently launch my monthly mentorship program, feel free to reach out and see what we can grow together:\n\n\u003ca href=\"https://mentorcruise.com/mentor/andychen/\"\u003e \u003cimg src=\"https://cdn.mentorcruise.com/img/banner/fire-sm.svg\" width=\"240\" alt=\"MentorCruise\"\u003e \u003c/a\u003e\n\n## Join the growing community\n\n[![Star History Chart](https://api.star-history.com/svg?repos=amazingandyyy/mern\u0026type=Date)](https://star-history.com/#amazingandyyy/mern\u0026Date)\n\n\n### License\n[MIT](https://github.com/amazingandyyy/mern/blob/master/LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famazingandyyy%2Fmern","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Famazingandyyy%2Fmern","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famazingandyyy%2Fmern/lists"}