mirror of
https://github.com/SrIzan10/featheroom.git
synced 2026-06-06 00:56:49 +00:00
feat: add readme
This commit is contained in:
115
README.md
115
README.md
@@ -1,105 +1,30 @@
|
||||
# expo-react-native-paper
|
||||
# featheroom
|
||||
|
||||
[](https://github.com/youzarsiph/expo-react-native-paper/actions/workflows/eas-build.yml)
|
||||
[](https://github.com/youzarsiph/expo-react-native-paper/actions/workflows/eas-reviews.yml)
|
||||
[](https://github.com/youzarsiph/expo-react-native-paper/actions/workflows/eas-update.yml)
|
||||
[](https://github.com/youzarsiph/expo-react-native-paper/actions/workflows/codeql.yml)
|
||||
[](https://github.com/youzarsiph/expo-react-native-paper/actions/workflows/eslint.yml)
|
||||
[](https://github.com/youzarsiph/expo-react-native-paper/actions/workflows/prettier.yml)
|
||||
Featheroom is an alternative client to the popular education [Google Classroom](https://classroom.google.com/). It is a web application that allows students to view their assignments, grades, and announcements in a more visually appealing way. It is built using React Native and company.
|
||||
|
||||
This repository is a template for React Native Expo applications. It integrates Expo Router and React Native Paper. It also demonstrates how to use Github Actions for linting and formatting.
|
||||
This is a submission for [Hack Club High Seas](https://highseas.hackclub.com).
|
||||

|
||||
|
||||
## Features
|
||||
## Tech stack
|
||||
|
||||
- Expo
|
||||
- Expo Router
|
||||
- Material Design V3
|
||||
- Light & Dark modes with custom themes
|
||||
- Cross Platform
|
||||
- LTR and RTL support
|
||||
- Multi lingual (`ar`, `en` and `tr`)
|
||||
- CI/CD. For more info checkout this [page](https://github.com/expo/expo-github-action/tree/main)
|
||||
|
||||
## Platforms
|
||||
|
||||
- Web
|
||||
- IOS
|
||||
- Android
|
||||
|
||||
## Screenshots
|
||||
|
||||

|
||||

|
||||

|
||||

|
||||

|
||||

|
||||

|
||||

|
||||

|
||||

|
||||
|
||||
## Getting Started
|
||||
|
||||
These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.
|
||||
|
||||
### Prerequisites
|
||||
|
||||
- Node.js
|
||||
- npm
|
||||
|
||||
### Installation
|
||||
|
||||
Clone the repo:
|
||||
|
||||
```bash
|
||||
git clone https://github.com/youzarsiph/expo-react-native-paper.git
|
||||
```
|
||||
|
||||
Open `package.json` and update the `name` field to match your app's name:
|
||||
|
||||
```jsonc
|
||||
{
|
||||
// Change the following line
|
||||
"name": "expo-react-native-paper",
|
||||
"main": "expo-router/entry",
|
||||
"version": "1.0.0",
|
||||
...
|
||||
}
|
||||
|
||||
```
|
||||
|
||||
Install dependencies:
|
||||
|
||||
```bash
|
||||
npm install
|
||||
```
|
||||
|
||||
Run the app:
|
||||
|
||||
```bash
|
||||
npm start
|
||||
```
|
||||
|
||||
## Built With
|
||||
|
||||
- TypeScript
|
||||
- React
|
||||
- React Native
|
||||
- Expo
|
||||
- Expo Router
|
||||
- React Native Paper
|
||||
- Firebase (to be changed to normal Google Cloud on release)
|
||||
- Tanstack Query
|
||||
- NativeWind (Tailwind)
|
||||
|
||||
## Platform support
|
||||
- [x] Android
|
||||
- [ ] iOS (will probably be supported on the first alpha release)
|
||||
|
||||
## How to run
|
||||
|
||||
1. Clone the repository
|
||||
2. Run `bun install` to install the dependencies
|
||||
3. Run `bun run android` to start the development server
|
||||
You may also need a google-services.json file to run the app. You can get it from the Firebase console. You may need to run more commands to get it up and running.
|
||||
|
||||
## Contributing
|
||||
|
||||
Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.
|
||||
|
||||
1. Fork the Project
|
||||
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
|
||||
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
|
||||
4. Push to the Branch (git push origin feature/AmazingFeature)
|
||||
5. Open a Pull Request
|
||||
|
||||
## License
|
||||
|
||||
Distributed under the MIT License. See LICENSE for more information.
|
||||
If you can help me out, please do! Note that I'm submitting for High Seas.
|
||||
@@ -77,7 +77,6 @@ export default function CourseBoard() {
|
||||
// eslint-disable-next-line react-hooks/exhaustive-deps
|
||||
}, [announcement, courseWork, courseWorkMaterial])
|
||||
|
||||
// TODO: THIS DOESNT WORK RAHH SEND HELP
|
||||
// inside a useeffect to make the loading spinner appear when adding a new announcement for example
|
||||
useEffect(() => {
|
||||
if (annIsLoading || cwIsLoading || cwmIsLoading) {
|
||||
|
||||
Reference in New Issue
Block a user