mirror of
https://github.com/sadan4/dotfiles.git
synced 2025-06-21 19:57:02 -04:00
start writing readme
This commit is contained in:
parent
ce5276759d
commit
742382445f
1 changed files with 48 additions and 0 deletions
48
README.md
Normal file
48
README.md
Normal file
|
@ -0,0 +1,48 @@
|
||||||
|
# Layout
|
||||||
|
|
||||||
|
this repo is a bit insane with how things are laid out
|
||||||
|
|
||||||
|
## ./boxes/\<system>/
|
||||||
|
has configuration.nix and hardware-configuration.nix as well as any other non-shared modules that are needed for said system
|
||||||
|
|
||||||
|
## ./common/
|
||||||
|
really a src dir
|
||||||
|
|
||||||
|
### ./common/programs/\<program>.nix
|
||||||
|
contains programs used used by the system and shared across systems
|
||||||
|
### ./common/systemModules/\<module>.nix
|
||||||
|
contains modules used by the system, eg ssh, nginx, audio, kernel
|
||||||
|
# ./common/users
|
||||||
|
This is where most of the code is
|
||||||
|
## ./common/users/docker/\<service>
|
||||||
|
the full configuration needed to setup and run a docker service, could include sops secrets, docker/docker compose files, and configuration files in clear text
|
||||||
|
make sure to enable linger on the user thats running them
|
||||||
|
### ./common/users/docker/\<service>/default.nix
|
||||||
|
a home manager module that installs this service to `~/src/<service>/`
|
||||||
|
> [!NOTE]
|
||||||
|
> I currently use a mix of `home.file`, `sops.secrets.<secret>.path` and `systemd.user.tmpfiles.rules` to manage needed files, if anyway knows a better way to move away from systed tmpfiles, please reach out and let me know
|
||||||
|
### ./common/users/docker/\<service>/nginx.nix
|
||||||
|
an system module, **not a home manager module**
|
||||||
|
|
||||||
|
setus up any nginx config needed for the service as well as any other needed system configuration that cant be done with home manager
|
||||||
|
> [!WARNING]
|
||||||
|
> This will not enable nginx or setup ssl certs, to do that, see /common/systemModules/nginx.nix
|
||||||
|
|
||||||
|
## ./common/users/homeModules/
|
||||||
|
contains all the modules for my configuration **most of the important code is here**
|
||||||
|
|
||||||
|
**each module should be able to standalone, please let me know if you find that any cant**
|
||||||
|
#### ./common/users/homeModules/dev/\<lang>
|
||||||
|
contains all config needed to run and develop code in that language
|
||||||
|
#### ./common/users/homeModules/dev/ide/\<editor>.nix
|
||||||
|
contains code for code editors and IDEs
|
||||||
|
|
||||||
|
has a default module for all ides
|
||||||
|
|
||||||
|
*nvim is not an IDE*
|
||||||
|
#### ./common/users/homeModules/dev/ide/jb/\<editor>.nix
|
||||||
|
contains all jet brains or IntelliJ based ides, eg: pycharm, android studio
|
||||||
|
|
||||||
|
has a default module for all ides
|
||||||
|
|
||||||
|
### ./common/users/homeModules/scripts
|
Loading…
Add table
Add a link
Reference in a new issue