mirror of
https://github.com/roleypoly/roleypoly.git
synced 2025-06-15 17:19:10 +00:00
docs: update README.md
This commit is contained in:
parent
74348afa47
commit
9a7d34ad6f
1 changed files with 13 additions and 16 deletions
29
README.md
29
README.md
|
@ -4,29 +4,26 @@ https://roleypoly.com
|
||||||
|
|
||||||
Tame your Discord roles.
|
Tame your Discord roles.
|
||||||
|
|
||||||
### Need Help with the App?
|
### Need Help with Roleypoly?
|
||||||
|
|
||||||
📚 [Please read through our community documentation.](https://github.com/roleypoly/community-docs)
|
📚 [Please read through our community documentation.](https://github.com/roleypoly/community-docs)
|
||||||
|
😕 [Still confused? Talk to us on Discord!](https://discord.gg/PWQUVsd)
|
||||||
|
|
||||||
## Developing
|
## Developing
|
||||||
|
|
||||||
Roleypoly is a distributed system built with Go, React, Terraform, and Bazel.
|
Roleypoly is a distributed system built with Go, React, Terraform, and Bazel.
|
||||||
|
|
||||||
### Prerequisites
|
This repo is currently being re-architected into a monorepo, so most processes might not be documented.
|
||||||
|
|
||||||
This app is known to work on Mac, Linux, and on WSL. Maintainer is typically using WSL.
|
### Quickstart
|
||||||
|
|
||||||
- **Required Tools**
|
This repo can be quickly setup with [VSCode Dev Containers](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) or [GitHub Codespaces](https://github.com/codespaces). This will setup a fully featured Docker container for developing VSCode, including extensions.
|
||||||
- Bazel
|
|
||||||
- Python (required for Bazel)
|
|
||||||
- Docker
|
|
||||||
- Docker Compose
|
|
||||||
- mkcert
|
|
||||||
- **Optional Tools**
|
|
||||||
- _Not having these isn't going to stop you from working on the app. Bazel is magic._
|
|
||||||
- ibazel
|
|
||||||
- Go 1.15+
|
|
||||||
- Node 14+
|
|
||||||
- Yarn
|
|
||||||
|
|
||||||
Setup a `.env` file copied from `.env.example`.
|
If you'd like to not use either of those, a docker image can be built from `.devcontainers/Dockerfile`, or used normally via `docker.pkg.github.com/roleypoly/roleypoly/dev-container`. This use case is not actively investigated, but with tinkering, will work. Feel free to document this process and open a PR :)
|
||||||
|
|
||||||
|
### Things to Know
|
||||||
|
|
||||||
|
Bazel can make some tasks far harder normal. Ideally, these are automated over.
|
||||||
|
|
||||||
|
- **Updating `go.mod`?**
|
||||||
|
- Run `hack/gazelle.sh` to regenerate `deps.bzl`.
|
||||||
|
|
Loading…
Add table
Add a link
Reference in a new issue