Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cl8n/project-loved-web
Website for osu!'s "Project Loved"
https://github.com/cl8n/project-loved-web
osu project-loved
Last synced: 9 days ago
JSON representation
Website for osu!'s "Project Loved"
- Host: GitHub
- URL: https://github.com/cl8n/project-loved-web
- Owner: cl8n
- License: mit
- Created: 2021-03-02T01:51:59.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2024-10-27T05:18:09.000Z (11 days ago)
- Last Synced: 2024-10-28T06:00:02.612Z (9 days ago)
- Topics: osu, project-loved
- Language: TypeScript
- Homepage: https://loved.sh
- Size: 4.02 MB
- Stars: 10
- Watchers: 3
- Forks: 18
- Open Issues: 80
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
> [!WARNING]
> This project is currently undergoing a major series of refactorings and will not be receiving many new features in the meantime. I don't recommend contributing to it at the moment either if you aren't already familiar with the codebase.
This project contains the web client (), API server (), and related tools for osu!'s [Project Loved](https://osu.ppy.sh/wiki/Project_Loved). See [cl8n/project-loved](https://github.com/cl8n/project-loved) for more management tools.
## Development with Docker
The provided Docker Compose configuration sets up a development environment with the client, API, MySQL, and Nginx. By default, Nginx is exposed to the host on port 8080, and MySQL on port 3306 (see [§ Environment variables](#environment-variables)).
### Environment variables
Two sets of environment variables are available at `.env` and `server/.env`. The former can be used to configure the Docker Compose environment, and the latter can be used to configure the API server.
During the containers' startup, each file will be created with a default configuration if it doesn't already exist. API server variables under "API server options" and "MySQL connection options" are overridden by the container.
### Live data
Regular database exports are posted to . They can be imported with the following command. **This will drop and re-create all tables!**
```
docker compose run --rm database import []
```
This will be run automatically to get the latest live data on the first run of the database container.
### Creating an admin user
```
docker compose run --rm api build/bin/create-admin.js
```
### Translations
Translations need to be extracted from the app and recompiled whenever English strings change.
```
docker compose run --rm assets sh -c 'npm run extract-translations && npm run compile-translations'
```
### Database migrations
`server/migrations` contains SQL to create the `project_loved` database schema. There are no backward migrations. Normally, running all migrations is not necessary, because the live data import on first run will create an up-to-date schema.
### Bridge package
The `bridge` directory contains a package required by both the client and server. You will need to rebuild it yourself if changes are made:
```
docker compose run --rm assets sh -c 'cd /app/bridge && npm install && npm run build-no-lint'
```
...and reinstall it in `client` and `server`, if its dependencies change:
```
docker compose run --rm assets npm install
docker compose run --rm api npm install
```
## Deployment
The `build.sh` script's `publish` target can be used to help automate deployments. Please read the script for more details.
### Dependencies
- [Node.js](https://nodejs.org/en/download/) 18
- [MySQL](https://dev.mysql.com/downloads/mysql/) 8
### Client
- `./build.sh client`
The built webpage will be in `client/build`; it's an SPA.
### Server
- `./build.sh server`
- Copy `.env.example` to `.env` and fill in the options, or export the environment variables separately
- Run the server: `NODE_ENV=production server/build/bin/server.js`
Request paths under `/api` should proxy to the server, paths exactly matching files should serve the files, and everything else should serve the client's `index.html`. See `docker/nginx.conf` for additional recommended configuration (but keep in mind that it's set up for a development environment).
Also note that the `loved-bridge` package is installed from `../bridge`, so it will need to be deployed either at that path or at the target of a symbolic link from that path.