1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
|
# PO connect-4
<p align="center">
<img src="https://img.shields.io/github/license/lonkaars/po-4-op-een-rij"/>
<img src="https://img.shields.io/github/languages/count/lonkaars/po-4-op-een-rij"/>
<img src="https://img.shields.io/static/v1?label=platform&message=linux"/>
<a href="https://discord.gg/FnapWQ9P7T"><img src="https://discordapp.com/api/guilds/820763086315061248/embed.png"/></a>
<br/>
<img alt="GitHub package.json version" src="https://img.shields.io/github/package-json/v/lonkaars/connect-4?label=latest">
<a href="https://connect4.pipeframe.xyz">
<img alt="Live commit version" src="https://img.shields.io/badge/dynamic/json?color=orange&label=live&query=version.commit_short&url=https%3A%2F%2Fconnect4.pipeframe.xyz%2Fapi%2Fstatus">
<img alt="Live commit version" src="https://img.shields.io/badge/dynamic/json?color=orange&label=live&prefix=v&query=version.number&url=https%3A%2F%2Fconnect4.pipeframe.xyz%2Fapi%2Fstatus">
</a>
<br/>
<a href="https://discord.gg/FnapWQ9P7T"><strong>Discord invite</strong></a>
</p>
> Some of this project's code is in Dutch (commit messages, documents etc.),
> along with the whole website. This was originally a school project, but I'm
> going to keep maintaining this project during my exams and summer break
## Planned features:
- [x] working connect 4 game
- [x] client-server connection with socket.io
- [x] account creation
- [ ] anonymous accounts
- [x] invite links
- [x] safe password authentication
- [ ] play against the computer
- [x] follow people/add as friend
- [ ] game rating like on chess.com
- [x] rest api that handles all of this instead of some janky solution
- [ ] Messages
- [ ] Multiple game modes
- [ ] Themes
- [ ] Animations
## Used libraries and frameworks:
- [Flask](https://flask.palletsprojects.com/) for the REST API
- [ReactJS](https://reactjs.org/) to create the website
- [NextJS](https://nextjs.org/) for static react pages and html page routing
- [socket.io](https://socket.io/) for bidirecitonal communication during a game
- [SQLite](https://sqlite.org/index.html) for the database
- [nginx](https://nginx.org/en/) for serving static files generated by nextjs,
caching and reverse proxy
A design prototype of the website can be found on
[Figma](https://www.figma.com/file/rTciVQApAe6cwrH1Prl5Wn/4-op-een-rij?node-id=0%3A1).
The api documentation can be found in api/readme.md.
## other readme's
- [api](api/readme.md)
- [voerbak](voerbak/readme.md)
- [styles](styles/readme.md)
## setup
To set up this project you'll need to install npm and pip dependencies, pull all
git submodules and compile voerbak and the sql extensions.
> I haven't figured out how to run this project on Windows, so please install
> [WSL](https://docs.microsoft.com/en-us/windows/wsl/install-win10) if you want
> to run this yourself on Windows. The distro you choose doesn't matter, though
> package names in ./config may vary if your distro doesn't use the apt package
> manager.
### automatic setup using `./config` (debian/ubuntu)
This script might also work on other distro's using the `apt` package manager.
To start the setup process you only need to run the following command:
```sh
./config
```
The script calls sudo and apt install so some password input/manual confirmation
is required, but most of the install should be automated.
### manual setup (other distro's)
If your disto doesn't use the `apt` package manager, you can still run this
project by following these steps:
0. `git clone https://github.com/lonkaars/po-4-op-een-rij`
1. Make sure you have [python](https://python.org/downloads) (with pip and venv)
installed.
2. Make sure you have [nodejs](https://nodejs.org/en/download) (with npm)
installed.
3. Make sure you have [nginx](https://nginx.org/en/) installed.
4. Make sure you have [make](https://www.gnu.org/software/make/) and the gnu c
compilers ([gcc](https://gcc.gnu.org/)) installed (most distro's will have
these by default).
5. Install typescript and yarn:
```sh
./config yarn_install
```
6. Create a new python virtual environment and install pip modules:
```sh
./config python_packages
```
7. Install node modules:
```sh
./config node_packages
```
8. Build voerbak:
```sh
./config voerbak
```
9. Download submodules:
```sh
./config submodules
```
10. Initialize database and build SQL extensions:
```sh
./config database
```
## How to start
In order to start this project you'll need three terminal windows to start the
flask server, react server, and nginx seperately:
```sh
# term 1
venv/bin/python3 api/main.py
# term 2
yarn dev
# term 3
sudo nginx -c $PWD/nginx.conf
# if nginx can't run as the user nobody, try running the following command and restart nginx:
./config customize_config
```
|