Skip to content

Commit 2d48d68

Browse files
authored
Merge pull request #92 from MathMan05/master
Add jank client
2 parents 2adfa02 + 89f1ba8 commit 2d48d68

File tree

3 files changed

+86
-0
lines changed

3 files changed

+86
-0
lines changed

docs/setup/clients/index.md

+2
Original file line numberDiff line numberDiff line change
@@ -1 +1,3 @@
11
## [Official Client](official)
2+
3+
## [Jank Client](jank)

docs/setup/clients/jank/index.md

+5
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
# Jank Client
2+
3+
Jank client currently only has 1 version:
4+
5+
- The web version which is currently under active development. [Web Client](web.md)

docs/setup/clients/jank/web.md

+79
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,79 @@
1+
# Web Jank Client
2+
3+
!!! warning "Jank client is under heavy development and not ready to be used in production yet."
4+
5+
Jank client is currently being developed at [this repository](https://github.com/MathMan05/JankClient).
6+
7+
## Official host
8+
9+
Jank Client is officially hosted [here](https://jankclient.greysilly7.xyz/)
10+
11+
!!! note
12+
13+
Jank client supports pointing to your own instance by default, you can read about it [here](https://github.com/MathMan05/JankClient/blob/main/InstanceInfo.md)
14+
15+
!!! warning
16+
17+
If you want you instance to play nice with other instances of Jank Client using their account switchers, you need to disable CORS, or allow requests from the instances of Jank Client you trust
18+
19+
## Setup/Building
20+
21+
### Dependencies
22+
23+
- [Git](https://git-scm.com/)
24+
- [NodeJS](https://nodejs.org) or [Bun](https://bun.sh/)
25+
26+
In your terminal:
27+
28+
```bash
29+
# Download Jank Client
30+
git clone https://github.com/MathMan05/JankClient.git
31+
32+
# Enter the cloned directory
33+
cd JankClient
34+
35+
# Install dependencies
36+
npm i
37+
38+
# Or if you're on bun
39+
bun i
40+
```
41+
then build the client
42+
43+
```bash
44+
npm run build
45+
46+
#or if you're on bun
47+
bun run build
48+
49+
```
50+
51+
To start the client, run
52+
53+
```bash
54+
npm run start
55+
56+
# If you're using bun
57+
bun run start
58+
```
59+
!!! note
60+
61+
Jank Client defualts to opening on port 8080, if you want to change the port you'll need to change either the env variable PORT or put the port on the command you run, ex: `npm start ./dist/index.js 43`
62+
63+
If you're wanting to also develop Jank Client, you'll need to start the typescript compiler in watch mode on the base directory of the project.
64+
65+
## Contributing
66+
67+
To contribute:
68+
69+
- Fork (Jank Client)[https://github.com/MathMan05/JankClient]
70+
- Run the building instructions.
71+
- Commit & push.
72+
- Pull request & done!
73+
74+
### What can I contribute?
75+
76+
- More settings, and general bug fixes, CSS improvements or anything you think needs to be fixed/improved
77+
- [This](https://github.com/users/MathMan05/projects/1/views/1) is a good list for things that need to be done, though it's incomplete, so if you think something is missing and you want to add it, just do it! MathMan05 is more than willing to answer your questions if you have any!
78+
- Even if you can't code, there's stuff you can still do! Like [reporting bugs](https://github.com/MathMan05/JankClient/issues), or updating the documentation! Even if you don't help Jank Client directly, if you contributed to the Spacebar server itself, it'd still be a huge help towards Jank Client, especially if you improve/fix op codes 8/14.
79+
- If you have a Spacebar instance you can put it on Jank Clients [instance list](https://github.com/MathMan05/JankClient/blob/main/InstanceInfo.md), if you don't it'll show up on Jank Client if it's on the [official instance list](https://github.com/spacebarchat/spacebarchat/tree/master/instances), but it's good if you do put it on the list as it'll let Jank Client have some additional information, and your instance will be higher on the list, even if you partially fill it out, Jank Client will merge both listings so no information is lost.

0 commit comments

Comments
 (0)