Updated README.md
This commit is contained in:
parent
8a22255955
commit
9547e4d1d1
1 changed files with 28 additions and 30 deletions
58
README.md
58
README.md
|
@ -4,6 +4,7 @@
|
||||||
|
|
||||||
An svg layout designer.
|
An svg layout designer.
|
||||||
|
|
||||||
|
|
||||||
# Getting Started
|
# Getting Started
|
||||||
|
|
||||||
Requirements :
|
Requirements :
|
||||||
|
@ -13,25 +14,38 @@ Requirements :
|
||||||
- [`git-lfs`](https://git-lfs.github.com/) (in order to clone the documentation)
|
- [`git-lfs`](https://git-lfs.github.com/) (in order to clone the documentation)
|
||||||
- `dotnet` (optional) used for api test
|
- `dotnet` (optional) used for api test
|
||||||
|
|
||||||
# Developping
|
|
||||||
|
|
||||||
Run `npm ci`
|
# Recommanded tools for developers
|
||||||
|
|
||||||
|
- [VSCode](https://code.visualstudio.com/)
|
||||||
|
- [React DevTools](https://chrome.google.com/webstore/detail/react-developer-tools/fmkadmapgofadopljbjfkapdkoienihi)
|
||||||
|
- [Typescript React code snippets](https://marketplace.visualstudio.com/items?itemName=infeng.vscode-react-typescript)
|
||||||
|
- [vscode-tailwindcss](https://marketplace.visualstudio.com/items?itemName=bradlc.vscode-tailwindcss)
|
||||||
|
- [vscode-eslint](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint)
|
||||||
|
|
||||||
|
|
||||||
|
# Develop
|
||||||
|
|
||||||
|
Run `npm i`
|
||||||
|
|
||||||
Run `npm run dev`
|
Run `npm run dev`
|
||||||
|
|
||||||
|
|
||||||
# Deploy
|
# Deploy
|
||||||
|
|
||||||
Run `npm ci`
|
Run `npm i`
|
||||||
|
|
||||||
Run `npm run build`
|
Run `npm run build`
|
||||||
|
|
||||||
|
|
||||||
# Run the tests
|
# Run the tests
|
||||||
|
|
||||||
Run `npm ci`
|
Run `npm i`
|
||||||
|
|
||||||
Run `npm test`
|
Run `npm test`
|
||||||
|
|
||||||
|
Or run `npm test:full` to also test the C# API
|
||||||
|
|
||||||
|
|
||||||
# API
|
# API
|
||||||
|
|
||||||
|
@ -40,14 +54,13 @@ with a url address to a `state.json` file.
|
||||||
|
|
||||||
Example: `http://localhost:4000/?state=http://localhost:5000/state.json`
|
Example: `http://localhost:4000/?state=http://localhost:5000/state.json`
|
||||||
|
|
||||||
|
|
||||||
# Testing the external API
|
# Testing the external API
|
||||||
|
|
||||||
This program fetch the data structure from others applications, allowing it to assemble them later.
|
This program fetch the data structure from others applications, allowing it to assemble them later.
|
||||||
|
|
||||||
## With NodeJS
|
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
node run ./test-server/node-http.js
|
node run ./test-server/http.js
|
||||||
```
|
```
|
||||||
|
|
||||||
The web server will be running at `http://localhost:5000`
|
The web server will be running at `http://localhost:5000`
|
||||||
|
@ -55,28 +68,6 @@ The web server will be running at `http://localhost:5000`
|
||||||
Copy `.env.development` to the file `.env.development.local`
|
Copy `.env.development` to the file `.env.development.local`
|
||||||
and change the url to whatever you want to use.
|
and change the url to whatever you want to use.
|
||||||
|
|
||||||
## With bun.sh
|
|
||||||
|
|
||||||
Install `bun`
|
|
||||||
|
|
||||||
Inside `test-server` folder, run :
|
|
||||||
|
|
||||||
```bash
|
|
||||||
bun run http.js
|
|
||||||
```
|
|
||||||
|
|
||||||
The web server will be running at `http://localhost:5000`
|
|
||||||
|
|
||||||
Copy `.env.development` to the file `.env.development.local`
|
|
||||||
and change the url to whatever you want to use.
|
|
||||||
|
|
||||||
# Recommanded tools
|
|
||||||
|
|
||||||
- [VSCode](https://code.visualstudio.com/)
|
|
||||||
- [React DevTools](https://chrome.google.com/webstore/detail/react-developer-tools/fmkadmapgofadopljbjfkapdkoienihi)
|
|
||||||
- [Typescript React code snippets](https://marketplace.visualstudio.com/items?itemName=infeng.vscode-react-typescript)
|
|
||||||
- [vscode-tailwindcss](https://marketplace.visualstudio.com/items?itemName=bradlc.vscode-tailwindcss)
|
|
||||||
- [vscode-eslint](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint)
|
|
||||||
|
|
||||||
# Setup debugging with chrome
|
# Setup debugging with chrome
|
||||||
|
|
||||||
|
@ -105,14 +96,21 @@ Change the `url` to the dev server url. Set the `runtimeExecutable` to your favo
|
||||||
|
|
||||||
# Generate definition files for SmartModeler
|
# Generate definition files for SmartModeler
|
||||||
|
|
||||||
Pre-requisite: `typescript`, `python3`
|
Prerequisites: `typescript`, `python3`
|
||||||
|
|
||||||
Go to the `src/dts` directory and run the following command
|
Go to the `src/dts` directory and run the following command
|
||||||
|
|
||||||
|
```
|
||||||
|
npx tsc --project tsconfig.dts.json
|
||||||
|
```
|
||||||
|
|
||||||
|
Or if installed globally
|
||||||
|
|
||||||
```
|
```
|
||||||
tsc --project tsconfig.dts.json
|
tsc --project tsconfig.dts.json
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
||||||
Then, run `python3` (or `py` on Windows) on `generate_dts.py`:
|
Then, run `python3` (or `py` on Windows) on `generate_dts.py`:
|
||||||
|
|
||||||
```
|
```
|
||||||
|
|
Loading…
Add table
Add a link
Reference in a new issue