Skip to content

Commit

Permalink
upate readme: dev guide #111
Browse files Browse the repository at this point in the history
  • Loading branch information
alireza0 committed Jun 30, 2024
1 parent ea85381 commit 60b374e
Showing 1 changed file with 52 additions and 2 deletions.
54 changes: 52 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@
| Multi-Client/Inbound | :heavy_check_mark: |
| Advanced Traffic Routing Interface | :heavy_check_mark: |
| Client & Traffic & System Status | :heavy_check_mark: |
| Subscription Service (link + info) | :heavy_check_mark: |
| Subscription Service (link/json + info)| :heavy_check_mark: |
| Dark/Light Theme | :heavy_check_mark: |


Expand Down Expand Up @@ -104,6 +104,56 @@ docker build -t s-ui .

</details>

## Manual run + contribution

<details>
<summary>Click for details</summary>

### Build and run whole project
```shell
./runSUI.sh
```

### - Frontend

Frontend codes are in `frontend` folder in the root of repository.

To run it localy for instant developement you can use (apply automatic changes on file save):
```shell
cd frontend
npm run dev
```
> By this command it will run a `vite` web server on separate port `3000`, with backend proxy to `http://localhost:2095`. You can change it in `frontend/vite.config.mts`.
To build fronend:
```shell
cd frontend
npm run build
```

### - Backend
Backend codes are in `backend` folder in the root of repository.
> Please build fronend once before!
To build backend:
```shell
cd backend

# remove old frontend compiled files
rm -fr web/html/*
# apply new frontend compiled files
cp -R ../frontend/dist/ web/html/
# build
go build -o ../sui main.go
```

To run backend (from root folder of repository):
```shell
./sui
```

</details>

## Languages

- English
Expand Down Expand Up @@ -169,4 +219,4 @@ certbot certonly --standalone --register-unsafely-without-email --non-interactiv
</details>

## Stargazers over Time
[![Stargazers over time](https://starchart.cc/alireza0/s-ui.svg?variant=adaptive)](https://starchart.cc/alireza0/s-ui)
[![Stargazers over time](https://starchart.cc/alireza0/s-ui.svg)](https://starchart.cc/alireza0/s-ui)

0 comments on commit 60b374e

Please sign in to comment.