Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Updates readme. #151

Merged
merged 5 commits into from
Dec 27, 2023
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
80 changes: 78 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,2 +1,78 @@
# boba-frontend
Frontend for BobaBoard
# <img src="https://i.imgur.com/8kcsRh6.png" width="50px" valign="bottom"/> boba-frontend

<center>

![CircleCI](https://img.shields.io/circleci/build/github/BobaBoard/boba-frontend?style=for-the-badge&logo=CircleCI)
![GitHub last commit](https://custom-icon-badges.demolab.com/github/last-commit/BobaBoard/boba-frontend?style=for-the-badge&color=c6a0f6&logo=git-commit)
![GitHub closed pull requests](https://custom-icon-badges.demolab.com/github/issues-pr-closed/BobaBoard/boba-frontend?style=for-the-badge&color=a6da95&logo=git-pull-request-closed)
![GitHub pull requests](https://custom-icon-badges.demolab.com/github/issues-pr-raw/BobaBoard/boba-frontend?style=for-the-badge&color=f0c6c6&logo=git-pull-request)
[![Open issues](https://custom-icon-badges.demolab.com/github/issues/BobaBoard/boba-frontend?style=for-the-badge&color=91d7e3&logo=issue-opened)](https://github.com/BobaBoard/boba-frontend/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc)

</center>

## BobaBoard

BobaBoard is a modern, open source community-building software that draws
inspiration from old-school forums for functionality and from modern social
media for its style of interaction. It prioritizes privacy and fluidity of
identity for users within communities and allows high levels of customization
and fine-grained permission settings for users, community managers, and instance
owners. The unique UX encourages creative expression across different formats,
styles of communication, and community building.

You can find out more about BobaBoard in general on our
[website](https://www.bobaboard.com) and as a project by visiting our
[project guide](https://docs.bobaboard.com/docs/project/intro).

## This Repo

![Built Using](https://img.shields.io/badge/Built%20Using:-222222?style=for-the-badge)
![TypeScript Badge](https://img.shields.io/badge/TypeScript-222222?logo=typescript&logoColor=3178C6&style=for-the-badge)
![React Badge](https://img.shields.io/badge/React-222222?logo=react&logoColor=61DAFB&style=for-the-badge)
![React Query Badge](https://img.shields.io/badge/React%20Query-222222?logo=reactquery&logoColor=FF4154&style=for-the-badge)
![Playwright Badge](https://img.shields.io/badge/Playwright-222222?logo=playwright&logoColor=2EAD33&style=for-the-badge)
![Next.js Badge](https://img.shields.io/badge/Next.js-222222?logo=nextdotjs&logoColor=fff&style=for-the-badge)
![Yarn Badge](https://img.shields.io/badge/Yarn-222222?logo=yarn&logoColor=2C8EBB&style=for-the-badge)
enigmalea marked this conversation as resolved.
Show resolved Hide resolved

boba-frontend handles the interactions of our UI with the server, lays out the
pages that BobaBoard is made of, and supplies the functionality of those pages.

### Relationships To Other Repos

Boba-frontend requires [boba-backend](https://github.com/BobaBoard/boba-backend)
to function as it queries the backend for user, thread, and post states.

[Boba-components](https://github.com/BobaBoard/boba-components) provides
boba-frontend with its UI pieces primarily impacting the design of the UI.

> [!NOTE]
> The above description is an "aspirational state" for our repos and we are still working on defining what the boundaries between "boba-frontend" and "boba-components" is so this may be fuzzy in practice.

## Local Development

For detailed instructions on how to develop for BobaBoard, please check out the
links below:

- [Setup Your Development Environment](https://docs.bobaboard.com/docs/development/start-developing/setting-up-dev-env)
- [How to Install WSL](https://docs.bobaboard.com/docs/development/start-developing/wsl)
(Windows Only)
- [Install Boba-Frontend](https://docs.bobaboard.com/docs/development/start-developing/boba-frontend)

## Contributing

> [!Important]
> Our issue tracker is not up-to-date and we are specifically looking for people to help us wrangle issues into order. If you're very eager to start working, please contact us through our [tech form](https://docs.google.com/forms/d/e/1FAIpQLSdCX2_fZgIYX0PXeCAA-pfQrcLw_lSp2clGHTt3uBTWgnwVSw/viewform) (for coding) or our [non-tech form](https://forms.gle/Z44UreTxnbvFnoqc9) (for issue wrangling).

BobaBoard welcomes one-time contributions. Our volunteer
[Code of Conduct](https://docs.bobaboard.com/docs/volunteering/experience/code-of-conduct)
applies in all of our social spaces, including Github Discussions or when
commenting on issues or pull requests.

We are also always looking for long-term volunteers to help with coding,
documentation, and other efforts. If you'd like to become a BobaBoard volunteer,
please see the
[Volunteering Guide](https://docs.bobaboard.com/docs/volunteering) for details.

## License

![MIT License](https://img.shields.io/github/license/BobaBoard/boba-frontend?style=for-the-badge&color=A41931)