Skip to content

Commit

Permalink
docs: update readme
Browse files Browse the repository at this point in the history
  • Loading branch information
Quiddlee committed Jan 17, 2024
1 parent ecf3efe commit 701c0fb
Show file tree
Hide file tree
Showing 9 changed files with 168 additions and 21 deletions.
189 changes: 168 additions & 21 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,30 +1,177 @@
# React + TypeScript + Vite
# ⚛️ GraphiQL App

This template provides a minimal setup to get React working in Vite with HMR and some ESLint rules.
🦥 RS-School React Final Task.

Currently, two official plugins are available:
***GraphiQL:** Your interactive GraphQL IDE, empowering website development with syntax highlighting, autocompletion, and dynamic documentation 🤩.*

- [@vitejs/plugin-react](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react/README.md) uses [Babel](https://babeljs.io/) for Fast Refresh
- [@vitejs/plugin-react-swc](https://github.com/vitejs/vite-plugin-react-swc) uses [SWC](https://swc.rs/) for Fast Refresh
# Getting Started 🚀
To run our project locally, you would have to download zip file with our repository or clone it to your computer. ✨

## Expanding the ESLint configuration
## Setup and Running ⚠️

If you are developing a production application, we recommend updating the configuration to enable type aware lint rules:
What things do you need to do in order to run our project locally? 🤔

- Configure the top-level `parserOptions` property like this:
* Use node 18.x or higher. ⚡
* Installed [.git](https://git-scm.com/) on your computer. ✌️
* Code Editor of your choice. 📝
* Installed [npm](https://www.npmjs.com/). 📦

```js
export default {
// other rules...
parserOptions: {
ecmaVersion: 'latest',
sourceType: 'module',
project: ['./tsconfig.json', './tsconfig.node.json'],
tsconfigRootDir: __dirname,
},
}
## Installation And Preparation 🔮

First make sure you have all the things listed in the previous section. Then clone our repository to your computer: 👌

```
git clone https://github.com/Quiddlee/graphiql-app.git
```

or download zip file manually with our repository.

Navigate into project folder and run 📦:

```
npm install
```

Finally run a development server: 🤩
```
npm run dev
```
Aaaaand you're done! 🎉🥳

# Features 😍
![img.png](public/img.png)

![img_1.png](public/img_1.png)

![img_2.png](public/img_2.png)

![img_3.png](public/img_3.png)

## Available Scripts 🥑

Here you can find all the scripts that are available in our project. 🦚

Lint the App with **ESlint**: ✅

```
npm run lint
```

Format the App with **Prettier**: 🧹

```
npm run prettier:fix
```

Type check the App with **TypeScript**: 🦁

```
npm run type-check
```

Install **Husky** to enable pre-commit hooks: 🎣

```
npm run prepare
```

Run unit-tests with **Vitest**: 🧪

```
npm run test
```

Run unit-tests coverage with **Vitest**: 🧪

```
npm run coverage
```

**Build** project for production: 🎁

```
npm run build
```

**Preview** the **production build** locally: 👀

```
npm run preview
```

# Technology Stack ⚙️

## Developing 🦈
* **React.js** - The Web Framework used 💘
* **React** Router Dom - The Router 📍
* **TypeScript** - The Language 💖
* **Tailwind** - The CSS Framework 🍃
* **Vite** - The Bundler 📦
* **Material**/web - Material Design Web Components 💫
* **Firebase** - The Backend tooling 🔥

## Code Quality 🧹
* **Vitest** - The Test Runner 🧪
* **Testing** Library - The Testing Framework 🫂
* **React Testing Library** - The Testing Framework 🫂
* **ESLint** — Air-bnb base - The Linter 🔔
* **Prettier** - The Code Formatter 👏
* **Husky** - The Pre-commit Hooks 🪝
* **Lint Staged** - The Pre-commit Hooks Config 🦚
* **EditorConfig** - The Code Style Enforcer 😎
* **Clsx + Tailwind Merge** - The Tailwind Classnames Resolver 🎨

## External Libraries 📚
* **Yup** - The Form Validation Schema Builder 🏛️
* **React Hook Form** - The Form Library 📑
* **Framer** Motion - The Animation Library 😍
* **Codemirror** - The Code Editor 📝
* **Overlayscrollbars** - The Custom Scrollbar 📜
* **React Toastify** - The Toast Library 🍞

# App Design Guideline 🎨

The app is using the **Material Design 3** System aka **Material You**.

* **Figma** - The Design Tool 🎨
* **Design File** - [link](https://www.figma.com/file/2bUMq5pE5L91lJWB9S1jAX/GraphiQL-App-%F0%9F%9A%80?type=design&node-id=0%3A1&mode=design&t=v3gBWbiLESRO53BN-1)

![img_4.png](public/img_4.png)

# Core Development Team 👨‍💻

### **Bohdan Shcherbyna 🦁**

*Front-end. UI/UX Design.*

<img height="400px" src="public/img_5.png">

### Contact 👋:
* Email - ```[email protected]``` 📬
* Linkedin - [Bohdan Shcherbyna](https://www.linkedin.com/in/quiddle/) ✒️
* Telegram - [@Quiddle](https://t.me/quiddle) 📱
* GitHub - [Quiddlee](https://github.com/Quiddlee) 🦉

#

### **Oleksii Drohachov** 🦈
*Front-end. Back-end.*

<img height="400px" src="public/img_6.png">

### Contact 👋:
* Email - ```[email protected]``` 📬
* Linkedin - [Oleksii Drohachov](https://www.linkedin.com/in/oleksii-drohachov-b127a9245/) ✒️
* Telegram - [@Tedzury](https://t.me/tedzury) 📱
* GutHub - [Tedzury](https://github.com/Tedzury) 🦉

#

### **Harry Holubiev** 🐲
*Front-end.*

<img height="400px" src="public/img_7.png">

- Replace `plugin:@typescript-eslint/recommended` to `plugin:@typescript-eslint/recommended-type-checked` or `plugin:@typescript-eslint/strict-type-checked`
- Optionally add `plugin:@typescript-eslint/stylistic-type-checked`
- Install [eslint-plugin-react](https://github.com/jsx-eslint/eslint-plugin-react) and add `plugin:react/recommended` & `plugin:react/jsx-runtime` to the `extends` list
### Contact 👋:
* Email - ```[email protected]``` 📬
* GitHub - [barrydilan](https://github.com/barrydilan) 🦉
Binary file added public/img.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added public/img_1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added public/img_2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added public/img_3.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added public/img_4.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added public/img_5.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added public/img_6.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added public/img_7.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 701c0fb

Please sign in to comment.