Add some simple documentation
All checks were successful
continuous-integration/drone/push Build is passing
All checks were successful
continuous-integration/drone/push Build is passing
This commit is contained in:
parent
bcf84b1f39
commit
822cd4107d
2 changed files with 111 additions and 0 deletions
73
docs/Dependencies.md
Normal file
73
docs/Dependencies.md
Normal file
|
@ -0,0 +1,73 @@
|
||||||
|
# Dependencies
|
||||||
|
|
||||||
|
This document briefly explains the different dependencies located in the `package.json`.
|
||||||
|
|
||||||
|
This document will not explain how to use them. You can read their documentation for that and the codebase have exemples for references.
|
||||||
|
|
||||||
|
|
||||||
|
# [React](https://reactjs.org/)
|
||||||
|
|
||||||
|
Main framework to build the js application.
|
||||||
|
|
||||||
|
It depends on Vite in order to build the project.
|
||||||
|
|
||||||
|
Others dependencies:
|
||||||
|
- [react-dom](https://reactjs.org/docs/react-dom.html): library used to inject the app to `#root` html element.
|
||||||
|
- [react-svg-pan-zoom](https://www.npmjs.com/package/react-svg-pan-zoom): component that offers pan + zoom to a svg element
|
||||||
|
|
||||||
|
|
||||||
|
# [Vite](https://vitejs.dev/)
|
||||||
|
|
||||||
|
Vite is the main tool to develop the react application.
|
||||||
|
|
||||||
|
Its uses the following files to configure the project :
|
||||||
|
- `vite.config.ts`
|
||||||
|
- `.env*`
|
||||||
|
- `src/vite-env.d.ts`
|
||||||
|
|
||||||
|
Others dependencies:
|
||||||
|
- @vitejs/plugin-react
|
||||||
|
|
||||||
|
|
||||||
|
# [Tailwind CSS](https://tailwindcss.com/)
|
||||||
|
|
||||||
|
CSS framework designed around constraints with utility classes in order to reduce dead css code.
|
||||||
|
|
||||||
|
Its uses the following files to configure the project :
|
||||||
|
- `src/index.scss`
|
||||||
|
- `tailwind.config.cjs`
|
||||||
|
- `postcss.config.cjs`
|
||||||
|
|
||||||
|
Other dependencies:
|
||||||
|
- postcss
|
||||||
|
- sass
|
||||||
|
- autoprefixer
|
||||||
|
|
||||||
|
|
||||||
|
# [Heroicons](https://heroicons.com/)
|
||||||
|
|
||||||
|
SVG Icons that can be used as JSX elements with Tailwind CSS
|
||||||
|
|
||||||
|
|
||||||
|
# Testing
|
||||||
|
|
||||||
|
- [Vitest](https://vitest.dev/)
|
||||||
|
- [Testing Library](https://testing-library.com/)
|
||||||
|
- [jsdom](https://github.com/jsdom/jsdom)
|
||||||
|
|
||||||
|
|
||||||
|
# [eslint](https://eslint.org/)
|
||||||
|
|
||||||
|
A Linter. Used for error checking, syntax checking and code style enforcing.
|
||||||
|
|
||||||
|
Currently using `standard-with-typescript` with a few modification.
|
||||||
|
|
||||||
|
See the `.eslintrc.cjs` for more informations.
|
||||||
|
|
||||||
|
Other dependencies:
|
||||||
|
- typescript-eslint/eslint-plugin
|
||||||
|
- typescript-eslint/parser
|
||||||
|
- eslint-plugin-import
|
||||||
|
- eslint-plugin-n
|
||||||
|
- eslint-plugin-promise
|
||||||
|
- eslint-plugin-react
|
38
docs/Project_Structure.md
Normal file
38
docs/Project_Structure.md
Normal file
|
@ -0,0 +1,38 @@
|
||||||
|
# Project Structure
|
||||||
|
|
||||||
|
The project is structured this way
|
||||||
|
|
||||||
|
```
|
||||||
|
.
|
||||||
|
├── docs Documentation folder
|
||||||
|
├── public Public folder in which the index.html
|
||||||
|
│ import its resources
|
||||||
|
├── src Source folder for the react app
|
||||||
|
│ ├── assets Assets folder in which the react app
|
||||||
|
│ │ import its resources
|
||||||
|
│ ├── Components Components folder
|
||||||
|
│ ├── Enums Enums folder
|
||||||
|
│ ├── Interfaces Interface (+ types folder)
|
||||||
|
│ ├── test Setup folder for the tests
|
||||||
|
│ ├── tests Other tests + resources
|
||||||
|
│ ├── utils Utilities folder
|
||||||
|
│ ├── index.scss Tailwind CSS extends
|
||||||
|
│ ├── main.tsx Entrypoint for App injection
|
||||||
|
│ └── vite-env.d.ts Types for .env files
|
||||||
|
├── test-server Tests servers to test the API
|
||||||
|
│ ├── http.js Test server for bun.sh
|
||||||
|
│ └── node-http.js Test server for Node.js
|
||||||
|
├── azure-pipelines.yml Azure Pipelines YAML config file
|
||||||
|
├── index.html HTML Page
|
||||||
|
├── package-lock.json Describe the node_modules tree for npm
|
||||||
|
├── package.json Node.JS config file
|
||||||
|
├── pnpm-lock.yaml Describe the node_modules tree for pnpm
|
||||||
|
├── postcss.config.cjs Postcss config file for SCSS processing
|
||||||
|
├── README.md
|
||||||
|
├── tailwind.config.cjs Tailwind CSS config file
|
||||||
|
├── tsconfig.json Typescript config file
|
||||||
|
├── tsconfig.node.json Typescript config file for Node modules
|
||||||
|
├── vite.config.ts Vite config file
|
||||||
|
└── vitest.config.ts Vitest config file
|
||||||
|
```
|
||||||
|
|
Loading…
Add table
Add a link
Reference in a new issue