revite/README.md

71 lines
2.8 KiB
Markdown
Raw Normal View History

2021-06-22 13:41:31 -04:00
# Revite
2021-06-18 07:05:01 -04:00
## Description
2021-06-22 13:41:31 -04:00
This is the web client for Revolt, which is also available live at [app.revolt.chat](https://app.revolt.chat).
2021-06-22 04:21:09 -04:00
2022-06-09 09:58:39 -04:00
## Pending Rewrite
The following code is pending a partial or full rewrite:
- `src/components`: components are being migrated to [revoltchat/components](https://github.com/revoltchat/components)
- `src/styles`: needs to be migrated to [revoltchat/components](https://github.com/revoltchat/components)
- `src/lib`: this needs to be organised
## Stack
2021-06-22 13:41:31 -04:00
- [Preact](https://preactjs.com/)
- [Vite](https://vitejs.dev/)
2021-06-22 13:41:31 -04:00
## Submodule Hint
This project contains submodules. Run `git submodule init` after you clone this repository to initialize the submodules.
It is also recommended to run `git submodule update` after you pull from upstream.
## Resources
2021-06-22 13:41:31 -04:00
### Revite
2021-06-22 13:41:31 -04:00
- [Revite Issue Board](https://github.com/revoltchat/revite/issues)
- [Google Drive Folder with Screenshots](https://drive.google.com/drive/folders/1Ckhl7_9OTTaKzyisrWHzZw1hHj55JwhD)
2021-06-22 13:41:31 -04:00
### Revolt
- [Revolt Project Board](https://github.com/revoltchat/revolt/discussions) (Submit feature requests here)
- [Revolt Testers Server](https://app.revolt.chat/invite/Testers)
- [Contribution Guide](https://developers.revolt.chat/contributing)
2021-11-11 11:41:55 -05:00
## Quick Start
Get revite up and running locally.
```
git clone --recursive https://github.com/revoltchat/revite
cd revite
yarn
2022-09-03 09:06:29 -04:00
yarn build:deps
2021-11-11 11:41:55 -05:00
yarn dev
```
2022-04-23 12:25:33 -04:00
You can now access the client at http://local.revolt.chat:3000.
## CLI Commands
2021-06-22 13:41:31 -04:00
| Command | Description |
| --------------------------------------- | -------------------------------------------- |
| `yarn pull` | Setup assets required for Revite. |
| `yarn dev` | Start the Revolt client in development mode. |
| `yarn build` | Build the Revolt client. |
2022-09-03 09:06:29 -04:00
| `yarn build:deps` | Build external dependencies. |
| `yarn preview` | Start a local server with the built client. |
| `yarn lint` | Run ESLint on the client. |
| `yarn fmt` | Run Prettier on the client. |
| `yarn typecheck` | Run TypeScript type checking on the client. |
| `yarn start` | Start a local sirv server with built client. |
| `yarn start:inject` | Inject a given API URL and start server. |
| `yarn lint \| egrep "no-literals" -B 1` | Scan for untranslated strings. |
2021-06-22 13:41:31 -04:00
## License
2021-06-22 13:41:31 -04:00
Revite is licensed under the [GNU Affero General Public License v3.0](https://github.com/revoltchat/revite/blob/master/LICENSE).