Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
26 commits
Select commit Hold shift + click to select a range
1d6005c
docs: renovate
Lunarnovaa Jun 11, 2025
115cd58
docs/readme: rewrite & cleanup
Lunarnovaa Jun 11, 2025
57e53f6
docs: general cleanup
Lunarnovaa Jun 11, 2025
b8b911a
docs: rename CNAME
Lunarnovaa Jun 18, 2025
a0227e1
docs: fix merges
Lunarnovaa Jun 18, 2025
f85cd6b
docs: fix links
Lunarnovaa Jun 18, 2025
337638c
docs: move CNAME to file
Lunarnovaa Jun 19, 2025
e399755
docs: move markdown to own directory
Lunarnovaa Jun 19, 2025
4461176
docs: minor cleanup
Lunarnovaa Jun 19, 2025
16f1519
docs: fix merge conflict
Lunarnovaa Jun 19, 2025
e151110
docs/CONTRIBUTING: add section on `defaultText`
Lunarnovaa Jun 19, 2025
2ed92aa
docs: add build check workflow
Lunarnovaa Jun 19, 2025
e23aa70
docs: docs check workflow don't run on tests/** changes
Lunarnovaa Jun 19, 2025
bd3bff7
docs/TESTING: change example test to nushell
Lunarnovaa Jun 19, 2025
2a045da
docs: add lycheeLinkCheck gh workflow
Lunarnovaa Jun 19, 2025
d52cd58
docs: change README to index, move README to .github/
Lunarnovaa Jun 19, 2025
1f9fdd6
docs: fix some links
Lunarnovaa Jun 19, 2025
f48693e
flake: update ndg
Lunarnovaa Jun 19, 2025
6203d49
docs: general cleanup
Lunarnovaa Jun 20, 2025
066425f
meta: fix README.md
Lunarnovaa Jun 20, 2025
ff97aac
docs/contributing: add section on roles
Lunarnovaa Jun 20, 2025
34f1319
docs: fragment README
Lunarnovaa Jun 20, 2025
30bfd51
docs: init templates
Lunarnovaa Jun 21, 2025
df647aa
docs: fix minor typo
Lunarnovaa Jun 21, 2025
59145c5
docs: add heading anchors
Lunarnovaa Jun 21, 2025
bfaad2d
docs: minor changes
Lunarnovaa Jun 22, 2025
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
66 changes: 66 additions & 0 deletions .github/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,66 @@
# Hjem Rum

[Hjem]: https://github.com/feel-co/hjem
[documentation]: rum.snugnug.org
[our docs]: ./CONTRIBUTING.html
[@NotAShelf]: https://github.com/NotAShelf
[@eclairevoyant]: https://github.com/eclairevoyant
[contributors]: https://github.com/snugnug/hjem-rum/graphs/contributors
[Home Manager]: https://github.com/nix-community/home-manager
[license]: https://github.com/snugnug/hjem-rum/blob/main/LICENSE

A module collection for managing your `$HOME` with [Hjem].

## A brief explanation

> [!WARNING]
> Hjem Rum is currently considered alpha software―here be dragons. While many of
> us currently use its modules in our NixOS configurations, that does not mean
> it will necessarily offer a seamless experience yet, nor does it mean there
> will not be breaking changes (there will). As Hjem Rum continues to grow and
> evolve, it should become more stable and expansive, but please be patient as
> it is a hobby project. Furthermore, Hjem, the tooling Hjem Rum is built off
> of, is still unfinished and missing critical features, such as services. Hjem
> Rum is still useable, but it is not for the novice user.

Built off the Hjem tooling, Hjem Rum (loosely translated to "rooms of a home")
is a collection of modules for various applications intended to simplify `$HOME`
management for usage and configuration of applications.

Hjem was initially created as a streamlined implementation of the `home`
functionality that Home Manager provides. Hjem Rum, in contrast, is intended to
provide an expansive module collection as a useful abstraction for users to
configure their applications with ease, recreating Home Manager's complete
functionality.

## Usage and Documentation

Hjem Rum includes a full set of documentation, including an options search
system. Please see our [documentation] for both guides on installing Hjem Rum
and a full list of options that you can configure programs with.

## Contribution

If you are interested in contributing to Hjem Rum, please check out our
contributing guidelines on [our docs]. We are always interested in
contributions, particularly as Hjem Rum is a project with an inherently enormous
scope. If you are new, unfamiliar, or otherwise scared of trying to contribute,
please know that any contribution helps, big or small, and that reviewers are
here to help you contribute and write good code for this project.

## Credits

Credit goes to [@NotAShelf] and [@eclairevoyant] for creating Hjem.

We would also like to give special thanks to all [contributors], past and
present, for making Hjem Rum what it is today.

Additionally, we would like to thank everyone who has contributed or maintained
[Home Manager], as without them, this project likely would not be possible, or
even be conceived.

## License

All the code within this repository is protected under the GPLv3 license unless
explicitly stated otherwise within a file. Please see [LICENSE] for more
information.
43 changes: 43 additions & 0 deletions .github/workflows/docs-check.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
name: "Docs Check"
permissions: read-all

on:
pull_request:
branches:
- main
path:
- modules/collection/**
- modules/lib/**
- docs/**
- flake.nix
- flake.lock
- .github/workflows/docs-check.yml

jobs:
docs-check:
name: "Test build docs"
runs-on: ubuntu-latest

steps:
- name: Install Nix
uses: DeterminateSystems/nix-installer-action@main

- name: Checkout
uses: actions/checkout@v4

- name: Build documentation packages
run: nix build .#docs -Lv

lychee-check:
name: "Link checker"
runs-on: ubuntu-latest

steps:
- name: Install Nix
uses: DeterminateSystems/nix-installer-action@main

- name: Checkout
uses: actions/checkout@v4

- name: Build documentation packages
run: nix build .#docsLinkCheck -Lv
172 changes: 0 additions & 172 deletions README.md

This file was deleted.

1 change: 1 addition & 0 deletions docs/CNAME
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
rum.snugnug.org
Loading