technofab/nixlets
1
0
Fork 0
mirror of https://gitlab.com/TECHNOFAB/nixlets.git synced 2025-12-11 01:20:06 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions

style(README): format README.md

Browse source
This commit is contained in:
technofab 2024-11-24 19:08:05 +01:00
parent a35b04034a
commit 6815e95725
1 changed files with 7 additions and 1 deletions
Download patch file Download diff file Expand all files Collapse all files

8
README.md
View file

@ -5,16 +5,18 @@ Nixlets are kinda like Helm Charts, but they are defined using Kubenix and the N
\
One can load Nixlets either via Nix Flakes or by fetching a tarball
## Usage
### Creating Nixlets
Nixlets need a `default.nix` and a `values.nix` (a `nixlet.nix` containing the metadata is also recommended). \
Check out the existing [nixlets](./nixlets/) to understand how they work. \
There is also a bare-bones [template](./template/).
### Using/rendering Nixlets
To render nixlets you only need to import the nixlets-lib:
```nix
{
inputs.nixlet-lib.url = "gitlab:TECHNOFAB/nixlets?dir=lib";
@ -22,6 +24,7 @@ To render nixlets you only need to import the nixlets-lib:
```
#### Nixlets stored in the Gitlab Package Registry
```nix
(nixlet-lib.fetchNixletFromGitlab {
project = "TECHNOFAB/nixlets";
@ -37,6 +40,7 @@ To render nixlets you only need to import the nixlets-lib:
```
#### Nixlets fetchable from arbitrary URLs
```nix
(nixlet-lib.fetchNixlet "<URL>" "<sha>").render {
# ...
@ -44,7 +48,9 @@ To render nixlets you only need to import the nixlets-lib:
```
#### Metadata
Metadata of the Nixlets can also easily be accessed if needed:
```nix
(<some nixlet>).description # version, name, etc.
```