I really hate these line endings
This commit is contained in:
@@ -1,91 +1,91 @@
|
|||||||
# MERN-template
|
# MERN-template
|
||||||
|
|
||||||
A website template using the MERN stack. The primary technology involved is:
|
A website template using the MERN stack. The primary technology involved is:
|
||||||
|
|
||||||
* React
|
* React
|
||||||
* Nodejs
|
* Nodejs
|
||||||
* MariaDB (with Sequelize)
|
* MariaDB (with Sequelize)
|
||||||
* Docker (with docker-compose)
|
* Docker (with docker-compose)
|
||||||
|
|
||||||
This template is designed to support the development of persistent browser based games (PBBGs), but it, and it's component microservices, can be used elsewhere.
|
This template is designed to support the development of persistent browser based games (PBBGs), but it, and it's component microservices, can be used elsewhere.
|
||||||
|
|
||||||
This template is released under the zlib license (see LICENSE).
|
This template is released under the zlib license (see LICENSE).
|
||||||
|
|
||||||
See the [github wiki](https://github.com/krgamestudios/MERN-template/wiki) for full documentation.
|
See the [github wiki](https://github.com/krgamestudios/MERN-template/wiki) for full documentation.
|
||||||
|
|
||||||
# Microservices
|
# Microservices
|
||||||
|
|
||||||
There are external components to this template referred to as "microservices". These can be omitted entirely by simply removing the React components that access them. These are also available via [docker hub](https://hub.docker.com/u/krgamestudios).
|
There are external components to this template referred to as "microservices". These can be omitted entirely by simply removing the React components that access them. These are also available via [docker hub](https://hub.docker.com/u/krgamestudios).
|
||||||
|
|
||||||
* News Server: https://github.com/krgamestudios/news-server
|
* News Server: https://github.com/krgamestudios/news-server
|
||||||
* Auth Server: https://github.com/krgamestudios/auth-server
|
* Auth Server: https://github.com/krgamestudios/auth-server
|
||||||
* Chat Server: https://github.com/krgamestudios/chat-server
|
* Chat Server: https://github.com/krgamestudios/chat-server
|
||||||
|
|
||||||
# Setup Deployment
|
# Setup Deployment
|
||||||
|
|
||||||
A clean install is this easy:
|
A clean install is this easy:
|
||||||
|
|
||||||
```
|
```
|
||||||
git clone https://github.com/krgamestudios/MERN-template.git
|
git clone https://github.com/krgamestudios/MERN-template.git
|
||||||
cd MERN-template
|
cd MERN-template
|
||||||
npm install
|
npm install
|
||||||
node configure-script.js
|
node configure-script.js
|
||||||
docker-compose up --build
|
docker-compose up --build
|
||||||
```
|
```
|
||||||
|
|
||||||
# Setup Development
|
# Setup Development
|
||||||
|
|
||||||
To set up this template in development mode:
|
To set up this template in development mode:
|
||||||
|
|
||||||
1. Ensure mariadb is running in your development environment
|
1. Ensure mariadb is running in your development environment
|
||||||
2. Run `mariadb sql/create_database.sql` as the root user
|
2. Run `mariadb sql/create_database.sql` as the root user
|
||||||
3. Run `npm install`
|
3. Run `npm install`
|
||||||
4. Run `cp .envdev .env` and enter your details into the `.env` file
|
4. Run `cp .envdev .env` and enter your details into the `.env` file
|
||||||
5. Execute `npm run dev`
|
5. Execute `npm run dev`
|
||||||
6. Navigate to `http://localhost:3001` in your web browser
|
6. Navigate to `http://localhost:3001` in your web browser
|
||||||
|
|
||||||
# Features List
|
# Features List
|
||||||
|
|
||||||
- Mainly one language across the codebase (JavaScript)
|
- Mainly one language across the codebase (JavaScript)
|
||||||
- Full documentation
|
- Full documentation
|
||||||
- Setup tutorial
|
- Setup tutorial
|
||||||
- Fully Featured Account System (as a microservice)
|
- Fully Featured Account System (as a microservice)
|
||||||
- Email validation
|
- Email validation
|
||||||
- Logging in and out
|
- Logging in and out
|
||||||
- Account deletion
|
- Account deletion
|
||||||
- Password management
|
- Password management
|
||||||
- JSON web token authentication
|
- JSON web token authentication
|
||||||
- Fully Featured News Blog (as a microservice)
|
- Fully Featured News Blog (as a microservice)
|
||||||
- Publish, edit or delete articles as needed
|
- Publish, edit or delete articles as needed
|
||||||
- Secured via admin panel
|
- Secured via admin panel
|
||||||
- Fully Featured Chat System (as a microservice)
|
- Fully Featured Chat System (as a microservice)
|
||||||
- Available when logged in
|
- Available when logged in
|
||||||
- Chat logs saved to the database
|
- Chat logs saved to the database
|
||||||
- Room-based chat (type `/room name` to access a specific room)
|
- Room-based chat (type `/room name` to access a specific room)
|
||||||
- Moderation tools
|
- Moderation tools
|
||||||
- Permanently banning users
|
- Permanently banning users
|
||||||
- Chat-muting users for a time period
|
- Chat-muting users for a time period
|
||||||
- Users reporting offensive chat-content
|
- Users reporting offensive chat-content
|
||||||
- Easy To Use Configuration Script
|
- Easy To Use Configuration Script
|
||||||
- Sets up everything via docker
|
- Sets up everything via docker
|
||||||
- A default admin account (if desired)
|
- A default admin account (if desired)
|
||||||
|
|
||||||
# Coming Soon
|
# Coming Soon
|
||||||
|
|
||||||
- Full documentation
|
- Full documentation
|
||||||
- Modding tutorials
|
- Modding tutorials
|
||||||
|
|
||||||
# Coming Eventually
|
# Coming Eventually
|
||||||
|
|
||||||
- Fully Featured News Blog (as a microservice)
|
- Fully Featured News Blog (as a microservice)
|
||||||
- Restore deleted articles
|
- Restore deleted articles
|
||||||
- Undo edits
|
- Undo edits
|
||||||
- Fully Featured Chat System (as a microservice)
|
- Fully Featured Chat System (as a microservice)
|
||||||
- Custom emoji
|
- Custom emoji
|
||||||
- Private messaging
|
- Private messaging
|
||||||
- Broadcasting to all channels
|
- Broadcasting to all channels
|
||||||
- Badges next to usernames
|
- Badges next to usernames
|
||||||
- Better compression for client files
|
- Better compression for client files
|
||||||
- Backend for leaderboards (modding tutorial?)
|
- Backend for leaderboards (modding tutorial?)
|
||||||
- Backend for energy systems (modding tutorial?)
|
- Backend for energy systems (modding tutorial?)
|
||||||
- Backend for items, shops, trading and currency
|
- Backend for items, shops, trading and currency
|
||||||
|
|||||||
+61
-61
@@ -1,61 +1,61 @@
|
|||||||
{
|
{
|
||||||
"name": "mern-template",
|
"name": "mern-template",
|
||||||
"version": "1.0.3",
|
"version": "1.0.3",
|
||||||
"description": "A website template using the MERN stack.",
|
"description": "A website template using the MERN stack.",
|
||||||
"main": "server/server.js",
|
"main": "server/server.js",
|
||||||
"scripts": {
|
"scripts": {
|
||||||
"start": "npm run build && node server/server.js",
|
"start": "npm run build && node server/server.js",
|
||||||
"build": "npm run build:server && npm run build:client",
|
"build": "npm run build:server && npm run build:client",
|
||||||
"build:server": "exit 0",
|
"build:server": "exit 0",
|
||||||
"build:client": "webpack --env=production --config webpack.config.js",
|
"build:client": "webpack --env=production --config webpack.config.js",
|
||||||
"dev": "concurrently npm:watch:server npm:watch:client",
|
"dev": "concurrently npm:watch:server npm:watch:client",
|
||||||
"watch:server": "nodemon ./* --ext js,jsx,json --ignore 'node_modules/*'",
|
"watch:server": "nodemon ./* --ext js,jsx,json --ignore 'node_modules/*'",
|
||||||
"watch:client": "webpack serve --env=development --config webpack.config.js",
|
"watch:client": "webpack serve --env=development --config webpack.config.js",
|
||||||
"analyzer": "webpack --env=production --analyzer --config webpack.config.js"
|
"analyzer": "webpack --env=production --analyzer --config webpack.config.js"
|
||||||
},
|
},
|
||||||
"repository": {
|
"repository": {
|
||||||
"type": "git",
|
"type": "git",
|
||||||
"url": "git+https://github.com/KRGameStudios/MERN-template.git"
|
"url": "git+https://github.com/KRGameStudios/MERN-template.git"
|
||||||
},
|
},
|
||||||
"author": "Kayne Ruse",
|
"author": "Kayne Ruse",
|
||||||
"license": "ISC",
|
"license": "ISC",
|
||||||
"bugs": {
|
"bugs": {
|
||||||
"url": "https://github.com/KRGameStudios/MERN-template/issues"
|
"url": "https://github.com/KRGameStudios/MERN-template/issues"
|
||||||
},
|
},
|
||||||
"homepage": "https://github.com/KRGameStudios/MERN-template#readme",
|
"homepage": "https://github.com/KRGameStudios/MERN-template#readme",
|
||||||
"dependencies": {
|
"dependencies": {
|
||||||
"@babel/core": "^7.14.8",
|
"@babel/core": "^7.14.8",
|
||||||
"@babel/preset-env": "^7.14.8",
|
"@babel/preset-env": "^7.14.8",
|
||||||
"@babel/preset-react": "^7.14.5",
|
"@babel/preset-react": "^7.14.5",
|
||||||
"@loadable/component": "^5.15.0",
|
"@loadable/component": "^5.15.0",
|
||||||
"babel-loader": "^8.2.2",
|
"babel-loader": "^8.2.2",
|
||||||
"clean-webpack-plugin": "^3.0.0",
|
"clean-webpack-plugin": "^3.0.0",
|
||||||
"concurrently": "^6.2.0",
|
"concurrently": "^6.2.0",
|
||||||
"css-loader": "^6.2.0",
|
"css-loader": "^6.2.0",
|
||||||
"dateformat": "^4.5.1",
|
"dateformat": "^4.5.1",
|
||||||
"dotenv": "^10.0.0",
|
"dotenv": "^10.0.0",
|
||||||
"express": "^4.17.1",
|
"express": "^4.17.1",
|
||||||
"html-webpack-plugin": "^5.3.2",
|
"html-webpack-plugin": "^5.3.2",
|
||||||
"jwt-decode": "^3.1.2",
|
"jwt-decode": "^3.1.2",
|
||||||
"mariadb": "^2.5.4",
|
"mariadb": "^2.5.4",
|
||||||
"query-string": "^7.0.1",
|
"query-string": "^7.0.1",
|
||||||
"raw-loader": "^4.0.2",
|
"raw-loader": "^4.0.2",
|
||||||
"react": "^17.0.2",
|
"react": "^17.0.2",
|
||||||
"react-dom": "^17.0.2",
|
"react-dom": "^17.0.2",
|
||||||
"react-dropdown-select": "^4.7.4",
|
"react-dropdown-select": "^4.7.4",
|
||||||
"react-markdown": "^6.0.2",
|
"react-markdown": "^6.0.2",
|
||||||
"react-router": "^5.2.0",
|
"react-router": "^5.2.0",
|
||||||
"react-router-dom": "^5.2.0",
|
"react-router-dom": "^5.2.0",
|
||||||
"rehype-raw": "^5.1.0",
|
"rehype-raw": "^5.1.0",
|
||||||
"sequelize": "^6.6.5",
|
"sequelize": "^6.6.5",
|
||||||
"socket.io-client": "^4.1.3",
|
"socket.io-client": "^4.1.3",
|
||||||
"style-loader": "^3.2.1",
|
"style-loader": "^3.2.1",
|
||||||
"webpack": "^5.46.0",
|
"webpack": "^5.46.0",
|
||||||
"webpack-bundle-analyzer": "^4.4.2",
|
"webpack-bundle-analyzer": "^4.4.2",
|
||||||
"webpack-cli": "^4.7.2"
|
"webpack-cli": "^4.7.2"
|
||||||
},
|
},
|
||||||
"devDependencies": {
|
"devDependencies": {
|
||||||
"nodemon": "^2.0.12",
|
"nodemon": "^2.0.12",
|
||||||
"webpack-dev-server": "^3.11.2"
|
"webpack-dev-server": "^3.11.2"
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
Reference in New Issue
Block a user