{"id":14988567,"url":"https://github.com/djizco/mern-boilerplate","last_synced_at":"2025-04-06T09:07:21.100Z","repository":{"id":40546682,"uuid":"131468928","full_name":"djizco/mern-boilerplate","owner":"djizco","description":"A Full MERN Stack Boilerplate for Web Apps including a local authentication system. Uses React, Express.js, MongoDB, Redux, Passport.js, Webpack, Testing, and more.","archived":false,"fork":false,"pushed_at":"2023-11-11T07:03:09.000Z","size":337,"stargazers_count":284,"open_issues_count":5,"forks_count":95,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-03-30T08:08:53.875Z","etag":null,"topics":["boilerplate","bulma","css","eslint","express","jest","mongodb","mongoose","nodejs","passport","ramda","react","redux","webpack"],"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/djizco.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}},"created_at":"2018-04-29T05:36:49.000Z","updated_at":"2025-03-22T14:24:09.000Z","dependencies_parsed_at":"2023-10-15T05:40:43.520Z","dependency_job_id":"2bb1cbf2-b4de-4b8b-a9ba-ad361f7e3581","html_url":"https://github.com/djizco/mern-boilerplate","commit_stats":null,"previous_names":[],"tags_count":15,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/djizco%2Fmern-boilerplate","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/djizco%2Fmern-boilerplate/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/djizco%2Fmern-boilerplate/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/djizco%2Fmern-boilerplate/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/djizco","download_url":"https://codeload.github.com/djizco/mern-boilerplate/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247457800,"owners_count":20941906,"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","bulma","css","eslint","express","jest","mongodb","mongoose","nodejs","passport","ramda","react","redux","webpack"],"created_at":"2024-09-24T14:16:57.158Z","updated_at":"2025-04-06T09:07:21.075Z","avatar_url":"https://github.com/djizco.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MERN Boilerplate\nMongoDB Express.js React.js Node.js\n\nA Full MERN Stack Boilerplate for Web Apps. Includes a local authentication system using passport. User is given a simple profile with Full Name and Profile Picture. User is also able to reset password and username case.\n\nNEW: For those of you who wish to separate the client and server into separate projects, I have created two repos that do just that! Check out [MERN Client](https://github.com/djizco/mern-client) and [MERN Server](https://github.com/djizco/mern-server).\n\n## Requirements\n\n* Operating System: MacOS or Linux\n* [Node.js](https://nodejs.org/) (I recommend installing with [NVM](https://github.com/nvm-sh/nvm))\n* [Homebrew](https://brew.sh) (to install MongoDB)\n\n## Quick Start\n\n#### Setup\n\n```bash\nnpm install\n\n# Install MongoDB\nbrew tap mongodb/brew\nbrew install mongodb-community\n```\n\nStart the database\n```bash\nbrew services start mongodb-community\n```\n\n#### for Development\n\nStart the client\n```bash\nnpm run start:client\n```\n\nStart the server\n```bash\nnpm run start:server\n```\n\nOr run client and server together\n```bash\nnpm start\n```\n\n#### for Production\n\n```bash\nnpm run build\nnpm start:server\n```\n\n#### Other Commands\n\n```bash\nnpm start\nnpm test\nnpm run lint\nnpm run lint:fix\nnpm run test:verbose\nnpm run test:coverage\nnpm run test:watch-client\nnpm run test:watch-server\n```\n\n## Setup Instructions\n\nNote: This is now a github template project. This makes copying the contents of the project\ninto a new repo very simple.\n\nTo setup your own project, you will need to copy the contents of this project into a new repo.\nYou will need to update the content in these files to names of your project and yourself:\n\n* package.json: name, version, description, repository, author, bugs, homepage\n* LICENSE: (update to your preferred license)\n* client/index.html: description and title\n* this README.md\n\nThis is also a good time to go through the included libraries to add or remove features that you want.\n\nAfter this you can commit the files into a new repository and push up to your github.\nYou can now start updating files in your client to begin working on your own project!\n\n## Features\n\n* Webpack conveniently bundles your code for you.\n* Babel lets you use ES6/7 features.\n* CSS pre-processor setup for LESS and SASS lets you keep your styles clean and organized.\n* ESLint helps you maintain a high level of code quality.\n* Jest gives you a robust testing framework to make sure your code works.\n\n## Code Structure\n\n```\n- client\n  - api\n  - assets\n    - images\n    - icons\n  - components\n    - pages\n    - environment\n  - hooks\n  - store\n    - actions\n    - reducers\n    - thunks\n    - tests\n  - styles\n  - utils\n- server\n  - config\n  - database\n  - routes\n- scripts\n```\n\n## Technologies\n\n[React](https://facebook.github.io/react/) - View Library\n\n[Redux](http://redux.js.org/) - State Manager\n\n[Webpack](https://webpack.github.io/) - Module Bundler\n\n[Express](http://expressjs.com/) - Node Application Framework\n\n[MongoDB](https://www.mongodb.com/) - Document Database\n\n[Mongoose](http://mongoosejs.com/) - MongoDB Framework\n\n[Passport](http://www.passportjs.org/) - Authentication Framework\n\n[React Notifications Component](https://teodosii.github.io/react-notifications-component/) - Notification System\n\n[Material-UI](http://material-ui.com/) - React Component Library\n\n[Bulma](http://bulma.io/) - CSS Framework\n\n[React Bulma Companion](https://github.com/djizco/react-bulma-companion) - Bulma Component Library\n\n[FontAwesome](http://fontawesome.io/) - Icons\n\n[Ramda](http://ramdajs.com/) - Functional Library\n\n[date-fns](https://date-fns.org/) - Date Functions Library\n\n[SuperAgent](https://github.com/visionmedia/superagent) - HTTP Request Library\n\n[ESLint](http://eslint.org/) - Code Linter\n\n[Jest](https://jestjs.io/) - Testing Framework\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdjizco%2Fmern-boilerplate","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdjizco%2Fmern-boilerplate","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdjizco%2Fmern-boilerplate/lists"}