ceos/agama

History

Imobach González Sosa f366460d99 [web] Automate the building process		2022-11-25 10:22:44 +00:00
..
package	[web] Automate the building process	2022-11-25 10:22:44 +00:00
po	Add Cockpit Starter Kit infrastructure	2022-04-08 21:07:13 +01:00
public	[web] Add Vite as a development dependency	2022-02-23 14:41:35 +00:00
src	[web] Use named exports intead of defaults ones	2022-11-22 11:43:24 +00:00
.babelrc.json	Add Cockpit Starter Kit infrastructure	2022-04-08 21:07:13 +01:00
.editorconfig	Add a React-based web interface	2021-12-22 10:02:10 +00:00
.eslintignore	Add Cockpit Starter Kit infrastructure	2022-04-08 21:07:13 +01:00
.eslintrc.json	[web] Allow using destructuring to remove properties	2022-11-03 08:21:45 +00:00
.gitignore	[web] Use typedoc to generate the documentation	2022-10-10 13:14:18 +01:00
.prettierignore	[web] Add 'lint' and 'prettier' tasks	2022-02-04 12:17:13 +00:00
.prettierrc	Set prettier printWidth to 100	2022-03-09 09:48:08 +00:00
babel.config.js	[web] Set up @testing-react-library and Jest	2022-02-23 14:41:35 +00:00
jest.config.js	[web] Define some alias for easy importing components	2022-11-21 16:21:39 +00:00
Makefile	Code cleanup and doc.	2022-06-10 09:16:34 +02:00
org.opensuse.d-installer.metainfo.xml	Add Cockpit Starter Kit infrastructure	2022-04-08 21:07:13 +01:00
package-lock.json	[web] Add packages for dealing with aliases	2022-11-21 16:21:39 +00:00
package.json	[web] Add packages for dealing with aliases	2022-11-21 16:21:39 +00:00
README.md	[web] Add a note about type checking support	2022-10-10 13:27:06 +01:00
tsconfig.json	[web] Define some alias for easy importing components	2022-11-21 16:21:39 +00:00
webpack.config.js	[web] Define some alias for easy importing components	2022-11-21 16:21:39 +00:00

README.md

D-Installer Web-Based UI

This Cockpit modules offers a UI to the D-Installer service. The code is based on Cockpit's Starter Kit (b2379f7).

Development

Cockpit searches for modules in the $HOME/.local/share/cockpit directory of the logged in user, which is really handy when working on a module. To make the module available to Cockpit, you can link your build folder (dist) or just rely on the devel-install task:

    make devel-install

Bear in mind that if something goes wrong while building the application (e.g., the linter fails), the link will not be created.

While working on the code, you might want to run the following command to refresh the build everytime you save a change:

    npm run watch

However, there is no live or hot reloading feature, so you need to reload the code in your browser. You can visit the module through the following URL: http://localhost:9090/cockpit/@localhost/d-installer/index.html.

JSDoc Documentation

This project uses TypeDoc to generate the API documentation. The jsdoc task generates the documentation to the jsout.out directory. If you need to adjust any TypeDoc option, please check the typedocOptions key in the tsconfig.js file.

npm run jsdoc
xdg-open jsdoc.out/index.html

GitHub Actions will automatically publish the result to https://d-installer-frontend.surge.sh/.

Type-Checking Support

This module started as a JavaScript-only project. We have decided to add type-checking support, but instead of converting the code to TypeScript, we prefer to use TypeScript support for JSDoc annotations.

Run the following command to check the types:

npm run check-types

Not our JavaScript code is properly documented yet, so type-checking is an opt-in feature by now. If you want a JavaScript file to be type-checked, please add a // @ts-check comment before any code.