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