refactor(readme): updated readme
Gitea Vite Build Action / Vite-Build (push) Successful in 39s
Details
Gitea Vite Build Action / Vite-Build (push) Successful in 39s
Details
Added section to readme: - getting started - technology stack - docker container Adjusted banner to take up 60% of width
This commit is contained in:
parent
6b3da418f7
commit
8acf99bcc1
46
README.md
46
README.md
|
@ -1,2 +1,46 @@
|
|||
|
||||
<img alt="banner" src="./assets/brunsviga_banner.svg" width="100%"/>
|
||||
<img alt="banner" src="./assets/brunsviga_banner.svg" width="60%"/>
|
||||
|
||||
<div align="center">
|
||||
<h2>Technology demonstration for 3D simulation of Brunsviga RK 13</h2>
|
||||
</div>
|
||||
|
||||
This repository is a demonstration of web technologies that might be used for simulating the Brunsviga RK 13 mechanical calculator.
|
||||
The demo is designed to be small and lightweight in deploment.
|
||||
|
||||
We use `vite` as the build system for a `react.js` web application that makes use `three.js` WebGL capabilites in order to render 3D objects and animate them in realtime.
|
||||
Typescript is the preferred language as it offers relative type-safety during development.
|
||||
The user interface is styled with `tailwindcss` and will refer to the paper, source code and some refernce documentation for the Brunsviga RK 13.
|
||||
|
||||
The built application can be delpoy via a static web server such as Nginx (see docker container).
|
||||
|
||||
## ☁️ Technology Stack
|
||||
|
||||
- Vite
|
||||
- React
|
||||
- Tailwind CSS
|
||||
- Three.js
|
||||
|
||||
## 🚀 Getting Started
|
||||
|
||||
In order to get started, clone the repository:
|
||||
```
|
||||
git clone https://git.montehaselino.de/servostar/brunsviga-demo.git
|
||||
```
|
||||
|
||||
Then build compile the application and run in development mode:
|
||||
```
|
||||
npm ci && npm run dev
|
||||
```
|
||||
|
||||
## 🐋 Docker Container
|
||||
|
||||
The application can be build and launched in a multi stage container:
|
||||
```
|
||||
docker build --tag brunsviga-demo:latest .
|
||||
```
|
||||
|
||||
Then run the container on port 80:
|
||||
```
|
||||
docker run -p 80:80 brunsviga-demo:latest
|
||||
```
|
||||
|
|
Loading…
Reference in New Issue