# c-entron Nexus (aka c-entron Web)

# Rules

## 1. Referencing javascript/css dependencies
When referencing any javascript or css dependency, we allow 2 ways of referencing them:  
1. Use LibMan to download the files into the repository.
2. Reference the files from a CDN like jsdelivr.net, but then we must include a integrity hash in that reference.

### Referencing javascript/css using LibMan
See here for how to use LibMan: https://learn.microsoft.com/en-US/aspnet/core/client-side/libman/libman-vs?view=aspnetcore-6.0

### Reference from CDN with integrity hash
You can use https://www.srihash.org/ to create the integrity hash for a file.

## 2. Which components to use
In general we prefer to use the DevExpress blazor components instead of plain bootstrap components.  
DevExpress uses the bootstrap styling, so the components do look similar.

## 3. Custom CSS
Don't use your own colors and border-radius and so on in custom CSS.  
Use whatever variables from bootstrap are available.  
This means, that we can change the bootstrap theme in the future and even our custom CSS will adjust.

## 4. HTML layouting
For layouting HTML stuff our preference is as follows:  
`CSS Grid` or `Flexbox` **>** `Bootstrap Grid` **>** DevExpress layout components (like `DxGridLayout` and `DxStackLayout`)

# Contributing

## 1. WebCart

* The webcart is a a feature primarily intended for the customers of our customers
* That means it's available if you login as a web-account (create one in c-entron.NET Adressstamm)
* The available articles come from the customers "Sonderpreise", so create some of them in the c-entron.NET Adressstamm too
* The web-account should now be able to login at c-entron Nexus, click on "Shop" and see the articles