https://github.com/meugenom/meugenom.com
[NO-AI] - Personal content system on pure Typescript, built with Spring-boot Java, GraphQl with using of Webpack, Github-API, Redis
https://github.com/meugenom/meugenom.com
backend frontend graphql java spring-boot tailwind typescript webpack5
Last synced: 3 months ago
JSON representation
[NO-AI] - Personal content system on pure Typescript, built with Spring-boot Java, GraphQl with using of Webpack, Github-API, Redis
- Host: GitHub
- URL: https://github.com/meugenom/meugenom.com
- Owner: meugenom
- Created: 2020-03-03T13:01:50.000Z (over 6 years ago)
- Default Branch: main
- Last Pushed: 2026-04-04T16:30:18.000Z (3 months ago)
- Last Synced: 2026-04-04T17:05:26.864Z (3 months ago)
- Topics: backend, frontend, graphql, java, spring-boot, tailwind, typescript, webpack5
- Language: TypeScript
- Homepage: https://meugenom.com
- Size: 10.5 MB
- Stars: 1
- Watchers: 1
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
## Personal Web Site:
[](https://meugenom.com)
### What is it:
This is my personal web page, that you can see [https://meugenom.com](https://meugenom.com).
### What were used to prepare this page:
- imported own markdown-ts-compiler v1.0.4 (Markdown->HTML [Markdown Typescript Compiler](https://github.com/meugenom/markdown-ts-compiler) with Tailwind CSS);
- used Typescript own [SPA MVC Router](https://github.com/meugenom/spa-mvc-router) on port 8082;
- Java and Spring-Boot (backend part on port 4000);
- GraphQL (frontend and backend part);
- Webpack (ES6);
- Tailwind CSS;
- maven;
- Redis (port 9001), set up etc/redis.conf with port 9001;
- Github Token and User Name
### How to set up:
1. Need preinstalled java 21 2023-09-19 LTS, npm(10.8.2), node(20.20.0), mvn(3.8.1), nginx(1.29.5 stable);
2. for information about projects you need personal access token [https://github.com/settings/tokens](https://github.com/settings/tokens);
3. Create .env file in the `client/.env`directory (see `client/simple.env`) and add this token to
```bash
# client/.env
# Token see 2.
GITHUB_TOKEN=YOUR_GITHUB_TOKEN
# Your Github Name
GITHUB_USER_NAME=YOUR_GITHUB_NAME
# by default APP_MODE=development or production
APP_MODE=development
# your graphql hostname
GRAPHQL_HOST=http://localhost:8080/graphql/
```
4. Change please title and description for meta tags in `client/src/js/config.ts`
```ts
title : "my title", // by default is "meugenom.com content platform",
description : "My Personal Content System", // by default is "Meugenom is a personal blog about software development, technology, and programming."
```
### How to start:
1. clone repository
`git clone https://github.com/meugenom/meugenom.com.git`
2. change dir
`cd meugenom.com/client`
3. install npm libraries
`yarn install`
4. for building frontend part:
`yarn build`
5. create .env file in the `client/.env`directory (see `client/simple.env`) and add this token to GITHUB_TOKEN= and github user name to GITHUB_USER_NAME=
6. start frontend server
**for development:**
- change .env file in the `client/.env`directory (see `client/simple.env`) and add to APP_MODE=development
- start frontend dev server (for development)
`yarn start`
**for production:**
- change .env file in the `client/.env`directory (see `client/simple.env`) and add to APP_MODE=production
- start frontend prod server (for production)
`node meugenom-server.js`
7. build backend part:
**for development:**
- `cd ../server`
- `mvn clean package`
**for production:** when is not local machine
- `cd ../server`
- `mvn clean package`
8. install Redis server and change port to 9001 in the `etc/redis.conf` file by default it's 6379
9. start backend dev server `mvn clean spring-boot:run`
or
**for development**
- `./start-dev-server.sh`
**for production**
- `./start-prod-server.sh`
### CORS settings:
1. write to "/etc/hosts" host:
127.0.0.1 localhost
2. Open nginx.conf, comment old locations and add this:
```bash
server {
listen 8080;
server_name localhost;
location / {
if ($request_method = OPTIONS) {
return 204;
}
add_header Access-Control-Allow-Origin *;
add_header Access-Control-Max-Age 3600;
add_header Access-Control-Expose-Headers Content-Length;
add_header Access-Control-Allow-Headers Range;
proxy_http_version 1.1;
proxy_cache_bypass $http_upgrade;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Forwarded-Host $host;
proxy_set_header X-Forwarded-Port $server_port;
proxy_pass http://localhost:8082;
}
location /graphql/ {
if ($request_method = OPTIONS) {
add_header Access-Control-Allow-Origin *;
add_header Access-Control-Allow-Methods 'GET, POST, OPTIONS';
add_header Access-Control-Allow-Headers 'Authorization, Content-Type, Accept';
add_header Access-Control-Max-Age 3600;
return 204;
}
add_header Access-Control-Allow-Origin *;
add_header Access-Control-Max-Age 3600;
add_header Access-Control-Expose-Headers Content-Length;
add_header Access-Control-Allow-Headers 'Authorization, Content-Type, Accept';
client_max_body_size 10M;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Forwarded-Host $host;
proxy_set_header X-Forwarded-Port $server_port;
# strip upstream CORS headers to avoid duplicates
proxy_hide_header Access-Control-Allow-Origin;
proxy_hide_header Access-Control-Allow-Methods;
proxy_hide_header Access-Control-Allow-Headers;
proxy_hide_header Access-Control-Max-Age;
proxy_hide_header Access-Control-Expose-Headers;
proxy_pass http://localhost:4000/graphql;
}
}
```
### Frontend Tests:
For testing web client is used jest framework in the `/client`
```bash
cd client &&
yarn test
```
or run to see tests coverage:
```bash
cd client &&
yarn test --coverage
```
### How to see web page:
open web browser with link: `http://localhost:8080` after starting both servers (front and back).
### Author
[meugenom](https://meugenom.com)