Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/ngkhang/exercises-for-everyone


https://github.com/ngkhang/exercises-for-everyone

Last synced: about 2 months ago
JSON representation

Awesome Lists containing this project

README

        

# πŸ‘‹Exercises for Everyone project



Documentation

Table of Contents:

- [πŸ‘‹Exercises for Everyone project](#exercises-for-everyone-project)
- [About this project](#about-this-project)
- [Challenges](#challenges)
- [Features](#features)
- [Technologies](#technologies)
- [Demo](#demo)
- [Screenshots](#screenshots)
- [Liveview](#liveview)
- [Getting Started](#getting-started)
- [Installation](#installation)
- [Environment Variables](#environment-variables)
- [Available Scripts](#available-scripts)
- [Run the app Dev mode](#run-the-app-dev-mode)
- [Lint](#lint)
- [Preview app](#preview-app)
- [Built app](#built-app)
- [Folder Structure](#folder-structure)
- [Contributing](#contributing)
- [Author](#author)

Refrence from Vite

- This template provides a minimal setup to get React working in Vite with HMR and some ESLint rules.
- Currently, two official plugins are available:
- [@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

- Expanding the ESLint configuration
If you are developing a production application, we recommend updating the configuration to enable type aware lint rules:

- Configure the top-level `parserOptions` property like this:

```js
parserOptions: {
ecmaVersion: 'latest',
sourceType: 'module',
project: ['./tsconfig.json', './tsconfig.node.json'],
tsconfigRootDir: __dirname,
},
```

- 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

---

## About this project

- Description:
- This is a boilerplate for React project using Vite, TypeScript, React Router DOM, Tailwind CSS, ESLint, and Airbnb Guide Style.
- If needed, you can install other frameworks or libraries.

### Challenges

- Using....

### Features

- Features...

### Technologies

- This project was bootstrapped with:
- **Vite**:
- **React**:
- **React Router DOM**:
- **TypeScript**:
- React + TypeScript:
- **Tailwind CSS**:
- **ESLint**:
- **Airbnb Guide Style**:
- React:
- ...

## Demo

### Screenshots

Toggle Show/Hide:

### Liveview

- Link: [Live](https//)
- Test Credentials:
- User

Email:
Password:

- Admin

Email:
Password:

## Getting Started

### Installation

1. Clone this respository

``` powershell
git clone https://github.com/ngkhang/exercises-for-everyone.git
```

2. Change to the project directory

``` powershell
cd exercises-for-everyone
```

3. Install the dependencies:

``` powershell
npm install
```

### Environment Variables

You can also checkout .env.example file

`API_KEY`

### Available Scripts

In the project directory, you can run:

#### Run the app Dev mode

- `npm run dev`: With localhost
Run command `npm run dev` and open to view it in the browser.
- `npm run dev:host`: With localhost and network

``` powershell
➜ Local: http://localhost:5173/
➜ Network: http://YOUR_IP:5173/
```

#### Lint

- The project uses ESLint and Airbnb Guide Style to lint the code. To run the linters, use the following commands:
- `npm run lint`: Check lint.
- `npm run lint:fix`: Auto fix some errors

#### Preview app

- Preview project before build production. You can run `npm run build` before preivew app.
- `npm run preview`: With localhost
Run command below and open to view it in the browser.
- `npm run preview:host`: With localhost and network

``` powershell
➜ Local: http://localhost:8080/
➜ Network: http://YOUR_IP:8080/
```

#### Built app

`npm run build`: Builds the app for production to the `dist` folder.

- The project can be deployed to a variety of platforms, such as Render, Firebase, Netlify, or Vercel.

---

## Folder Structure

The code for the project is organized as follows:

``` markdown
.
β”œβ”€β”€ .vscode
β”œβ”€β”€ node-modules
β”œβ”€β”€ public/
β”‚ └── assets
β”œβ”€β”€ src/
β”‚ β”œβ”€β”€ components/
β”‚ β”‚ β”œβ”€β”€ generic/
β”‚ β”‚ β”‚ β”œβ”€β”€ Header
β”‚ β”‚ β”‚ └── ...
β”‚ β”‚ └── layouts/
β”‚ β”‚ β”œβ”€β”€ defaultLayout
β”‚ β”‚ └── index.tsx
β”‚ β”œβ”€β”€ hooks
β”‚ β”‚ └── useCustom.tsx
β”‚ β”œβ”€β”€ pages/
β”‚ β”‚ └── HomePage
β”‚ β”‚ └── PageNotPound
β”‚ β”œβ”€β”€ routes/
β”‚ β”‚ └── index.tsx
β”‚ β”œβ”€β”€ services/
β”‚ β”‚ └── api
β”‚ β”œβ”€β”€ types
β”‚ β”œβ”€β”€ utils/
β”‚ β”‚ β”œβ”€β”€ constants/
β”‚ β”‚ β”‚ β”œβ”€β”€ dbPage.json
β”‚ β”‚ β”‚ └── index.tsx
β”‚ β”‚ β”œβ”€β”€ functions/
β”‚ β”‚ β”‚ └── handleFunc.tsx
β”‚ β”‚ └── helpers/
β”‚ β”‚ └── icons.tsx
β”‚ β”œβ”€β”€ App.css
β”‚ β”œβ”€β”€ App.tsx
β”‚ β”œβ”€β”€ index.css
β”‚ β”œβ”€β”€ main.tsx
β”‚ └── vite-env.d.ts
β”œβ”€β”€ .editorconfig
β”œβ”€β”€ .env
β”œβ”€β”€ .eslintignore
β”œβ”€β”€ .eslintrc.cjs
β”œβ”€β”€ .gitignore
β”œβ”€β”€ index.html
β”œβ”€β”€ package-lock.json
β”œβ”€β”€ package.json
β”œβ”€β”€ postcss.config.js
β”œβ”€β”€ README.md
β”œβ”€β”€ tailwind.config.js
β”œβ”€β”€ tsconfig.json
β”œβ”€β”€ tsconfig.node.json
└── vite.config.js
```

---

## Contributing

- Contributions are welcome! Please open an issue or a pull request if you have any ideas for improvement.
- Give a ⭐️ if this project helped you!

---

## Author

πŸ‘€ **Khang Nguyen**

[![portfolio](https://img.shields.io/badge/my_portfolio-FE7A16?style=for-the-badge&logo=ko-fi&logoColor=white)](https://ngkhang.onrender.com/)
[![linkedin](https://img.shields.io/badge/linkedin-0A66C2?style=for-the-badge&logo=linkedin&logoColor=white)](https://linkedin.com/in/ngkhang0220)
[![github](https://img.shields.io/badge/GitHub-100000?style=for-the-badge&logo=github&logoColor=white)](https://github.com/ngkhang)
[![leetcode](https://img.shields.io/badge/-LeetCode-FFA116?style=for-the-badge&logo=LeetCode&labelColor=black)](https://github.com/ngkhang)