owlboard-svelte/README.md

16 lines
1.1 KiB
Markdown
Raw Permalink Normal View History

# owlboard-svelte
2023-06-12 09:06:19 +01:00
owlboard-svelte is the OwlBoard web-frontend as of version 2023.7.1 replacing the previous version (https://git.fjla.uk/owlboard/web) and moving from a raw HTML/CSS/JS to a statically build Svelte website.
2023-06-12 19:02:49 +01:00
The decision was made because as new features were added, the markup and code started to become difficult to manage and maintain. The Svelte version introduces reusable components simplifying the maintenance and the addition of new features.
2023-06-12 19:02:49 +01:00
## Building
To build owlboard-svelte, simply clone the repo and run `npm run build` which will build a static website in the `build` folder. The static files can then be uplaoded to a webserver of your choice.
2023-06-12 19:02:49 +01:00
The website is build statically for server performance reasons - running an nginx server is lighter than running Node considering that much of the data fetching and processing happens on the client side anyway due to user UUID access keys being required.
2023-06-12 19:02:49 +01:00
## TypeScript
2023-06-12 19:02:49 +01:00
Any new code added to the website should be written in TypeScript - where Javascript is extended, it should be re-written into TypeScript.