Là một dự án mã nguồn mở, Hashnode/mern-starter đã đạt 5.1k sao trên GitHub, ngôn ngữ JavaScript. ⛔️ DEPRECATED - Boilerplate for getting started with MERN stack
Tóm tắt dựng từ metadata GitHub của chính dự án — chưa có bài review TopGit. Trang sẽ tự động cập nhật khi bài review đầy đủ được xuất bản.
VÌ SAO CHƯA CÓ REVIEW
TopGit viết bài đầy đủ cho repo có nhiều sao nhất và được yêu cầu nhiều nhất. Trang này là snapshot trong thời gian chờ — xem README gốc ở tab READ ME.
MERN is deprecated and is no longer actively maintained.
mern-starter
MERN is a scaffolding tool which makes it easy to build isomorphic apps using Mongo, Express, React and NodeJS. It minimises the setup time and gets you up to speed using proven technologies.
Website
Documentation
Discussions
Road to V3!
We're on our way towards V3, which will bring a few updates to MERN! We are tracking with the following milestones:
V2.4.0 -> Webpack 3 and many fixes Completed : list of changes
Note : Please make sure your MongoDB is running. For MongoDB installation guide see this. Also npm6 is required to install dependencies properly.
Available Commands
npm run start - starts the development server with hot reloading enabled
npm run bs - bundles the code and starts the production server
npm run test - start the test runner
npm run watch:test - start the test runner with watch mode
npm run cover - generates test coverage report
npm run lint - runs linter to check for lint errors
File Structure
Webpack Configs
MERN uses Webpack for bundling modules. There are four types of Webpack configs provided webpack.config.dev.js (for development), webpack.config.prod.js (for production), webpack.config.server.js (for bundling server in production) and webpack.config.babel.js (for babel-plugin-webpack-loaders for server rendering of assets included through webpack).
The Webpack configuration is minimal and beginner-friendly. You can customise and add more features to it for production build.
Server
MERN uses express web framework. Our app sits in server.js where we check for NODE_ENV.
If NODE_ENV is development, we apply Webpack middlewares for bundling and Hot Module Replacement.
Server Side Rendering
We use React Router's match function for handling all page requests so that browser history works.
All the routes are defined in client/routes.js. React Router renders components according to route requested.
// Server Side Rendering based on routes matched by React-router.
app.use((req, res) => {
match({
routes,
location: req.url
}, (err, redirectLocation, renderProps) => {
if (err) {
return res.status(500).end('Internal server error');
}
if (!renderProps) {
return res.status(404).end('Not found!');
}
const initialState = {
posts: [],
post: {}
};
const store = configureStore(initialState);
fetchComponentData(store.dispatch, renderProps.components, renderProps.params).then(() => {
const initialView = renderToString(
<Provider store = {store} >
<RouterContext {...renderProps}/>
</Provider>
);
const finalState = store.getState();
res.status(200).end(renderFullPage(initialView, finalState));
}).catch(() => {
res.end(renderFullPage('Error', {}));
});
});
});
match takes two parameters, first is an object that contains routes, location and history and second is a callback function which is called when routes have been matched to a location.
If there's an error in matching we return 500 status code, if no matches are found we return 404 status code. If a match is found then, we need to create a new Redux Store instance.
Note: A new Redux Store has populated afresh on every request.
fetchComponentData is the essential function. It takes three params: first is a dispatch function of Redux store, the second is an array of components that should be rendered in current route and third is the route params. fetchComponentData collects all the needs (need is an array of actions that are required to be dispatched before rendering the component) of components in the current route. It returns a promise when all the required actions are dispatched. We render the page and send data to the client for client-side rendering in window.__INITIAL_STATE__.
Client
Client directory contains all the shared components, routes, modules.
components
This folder contains all the common components which are used throughout the project.
index.js
Index.js simply does client side rendering using the data provided from window.__INITIAL_STATE__.
modules
Modules are the way of organising different domain-specific modules in the project. A typical module contains the following
.
└── Post
├── __tests__ // all the tests for this module goes here
| ├── components // Sub components of this module
| | ├── Post.spec.js
| | ├── PostList.spec.js
| | ├── PostItem.spec.js
| | └── PostImage.spec.js
| ├── pages
| | ├── PostPage.spec.js
| | └── PostViewPage.spec.js
| ├── PostReducer.spec.js
| └── PostActions.spec.js
├── components // Sub components of this module
| ├── Post.js
| ├── PostList.js
| ├── PostItem.js
| └── PostImage.js
├── pages // React Router Pages from this module
| ├── PostPage
| | ├── PostPage.js
| | └── PostPage.css
| └── PostViewPage
| ├── PostViewPage.js
| └── PostViewPage.css
├── PostReducer.js
└── PostActions.js
Misc
Importing Assets
Assets can be kept where you want and can be imported into your js files or css files. Those fill be served by webpack in development mode and copied to the dist folder during production.
ES6 support
We use babel to transpile code in both server and client with stage-0 plugin. So, you can use both ES6 and experimental ES7 features.
Docker
There are docker configurations for both development and production.
To run docker for development:
docker-compose build # re-run after changing dependencies
docker-compose up
or, if you want to override the web port:
WEB_PORT=<your_custom_port> docker-compose up
To run docker for production:
docker-compose -f docker-compose-production.yml up --build
To reset the database:
docker-compose down --volumes
Make your MERN
In this version, we enabled the mern-cli to clone not only this project but also the variants of mern-starter like one project with MaterialUI or JWT auth. To make your version of MERN, follow these steps
Make your changes. Add a package, add authentication, modify the file structure, replace Redux with MobX or anything else.
In this version, we also added code generators. Blueprints for those generators are located at config/blueprints, and config is located at mern.json. Make sure to edit them if necessary after your made modifications in the previous step. There is a section below which explains how to modify generators.
Next clone mern-cli project
git clone https://github.com/Hashnode/mern-cli
Add your project details to variants.json in the cloned project and send a pull request.
Modifying Generators
mern.json
It contains a blueprints array. Each object in it is the config for a generator. A blueprint config contains the name, description, usage, and files array. An example blueprint config
target-path - location where the file should be generated
parent-path - optional parameter, used if you want to generate the file inside an already existing folder in your project.
Also, target-path supports ejs and the following variables will be passed while rendering,
name - <component-name> input from user
parent - in particular special cases where you need to generate files inside an already existing folder, you can obtain this parent variable from the user. A config using that will look like,
Here, notice the usage. In <module-name>/<component-name>, <module-name> will be passed as parent and <component-name> will be passed as <name>.
helpers - an helper object is passed which include common utility functions. For now, it contains capitalize. If you want to add more, send a PR to mern-cli.
Blueprint files
Blueprints are basically ejs templates which are rendered with the same three variables (name, optional parent and helpers object) as above.
Caveats
FOUC (Flash of Unstyled Content)
To make the hot reloading of CSS work, we are not extracting CSS in development. Ideally, during server rendering, we will be extracting CSS, and we will get a .css file, and we can use it in the html template. That's what we are doing in production.
In development, after all scripts get loaded, react loads the CSS as BLOBs. That's why there is a second of FOUC in development.
Client and Server Markup Mismatch
This warning is visible only on development and totally harmless. This occurs to hash difference in react-router. To solve it, react router docs asks you to use match function. If we use match, react-hot-reloader stops working.
Trang TopGit này là một snapshot — tab "Readme" hiển thị nguyên văn README của repo (đã bỏ link, giữ ảnh). Repo GitHub ở github.com/Hashnode/mern-starter là nguồn chính thức.
Hashnode/mern-starter có bao nhiêu sao?
Hashnode/mern-starter có 5.1k sao GitHub — tải lại trang để xem số mới nhất, hoặc xem trực tiếp github.com/Hashnode/mern-starter. TopGit phản chiếu số sao của GitHub nhưng không cam kết đến từng phút.
Hashnode/mern-starter có những chủ đề gì?
GitHub topics của Hashnode/mern-starter: "archived", "deprecated", "obsolete". TopGit xếp repo vào nhóm mã nguồn mở.
Hashnode/mern-starter có website riêng không?
TopGit chưa ghi nhận URL trang chủ cho Hashnode/mern-starter. Phần README ở tab phía trên thường có link demo, hoặc xem mô tả GitHub của repo.
Hashnode/mern-starter còn đang phát triển không?
Commit gần nhất trên Hashnode/mern-starter là 3.8 năm trước (theo timestamp GitHub). Repo có 1.1k fork — một chỉ báo về mức độ quan tâm của cộng đồng.
Hashnode/mern-starter dùng license gì?
Hashnode/mern-starter phát hành theo license MIT. Nên mở file LICENSE trên GitHub để xác nhận — license metadata đôi khi lệch với thực tế dự án.
Hashnode/mern-starter viết bằng ngôn ngữ gì?
Hashnode/mern-starter chủ yếu viết bằng JavaScript. Trường "language" của GitHub dựa trên phần lớn byte ở nhánh mặc định.
Đọc đầy đủ README ở tab phía trên.
Vẫn đang phân vân về mern-starter?
Một cú bấm sẽ gửi câu hỏi kèm trang này cho AI — xem AI nói gì về mern-starter.