mirror of
				https://github.com/Jokiller230/puzzlevision.git
				synced 2025-10-31 13:50:04 +00:00 
			
		
		
		
	📝 Update README.md to reflect recent changes
This commit is contained in:
		
							parent
							
								
									880ae420ea
								
							
						
					
					
						commit
						353573e280
					
				
					 1 changed files with 25 additions and 20 deletions
				
			
		
							
								
								
									
										45
									
								
								README.md
									
										
									
									
									
								
							
							
						
						
									
										45
									
								
								README.md
									
										
									
									
									
								
							|  | @ -11,22 +11,18 @@ | ||||||
| </div> | </div> | ||||||
| <br> | <br> | ||||||
| 
 | 
 | ||||||
| ## 🚧 State of development | ## 💡 How does this work? | ||||||
| All the basic functionality of v2 should be working correctly, including: | At its core, version 2 of my NixOS flake was aimed at improving the following regions of my previous setup: | ||||||
| 
 | 
 | ||||||
| - The custom lib implementation at self.lib, recursively built from the contents of the `lib` directory. | - Implementing my own custom library at self.lib, recursively built from the contents of the `lib` directory. | ||||||
| - Loading of systems from the `systems` directory, using easy-hosts. | - Loading of systems from the `systems` directory, using easy-hosts. | ||||||
|   - A basic workstation archetype for desktop systems. |   - Archetypes for various systems, as seen in [Jake Hamilton's](https://github.com/jakehamilton) flake. | ||||||
| - Creating users in your systems through ${self.namespace}.users, | - Creating users in my systems through a unified NixOS module, with automated home-manager setups derived from the `homes` directory. | ||||||
| automatically maps home-manager configurations from the `homes` directory to their corresponding users. |  | ||||||
| 
 | 
 | ||||||
| Since I am actively using this configuration on my main workstation, things are evolving quickly, | Since I am actively using this configuration on my main workstation and Server, things have mostly stabilized, | ||||||
| leftover issues are actively being resolved and the list of modules is ever-growing. | leftover issues are sparse and the list of modules is nearing completion (for my purposes that is). | ||||||
| Nonetheless, one should still consider this implementation experimental. |  | ||||||
| 
 | 
 | ||||||
| My next goal is to setup an attic binary cache, | As such, I personally consider this flake production ready. | ||||||
| with a build/release workflow that runs in regular intervals. |  | ||||||
| (similar to isabelroses's workflow setup) |  | ||||||
| 
 | 
 | ||||||
| ## 🚀 Deployment | ## 🚀 Deployment | ||||||
| To deploy a system run the following command in your terminal of choice. | To deploy a system run the following command in your terminal of choice. | ||||||
|  | @ -97,15 +93,23 @@ To be specific, it does the following: | ||||||
| 2. Installs nix with some experimental features (flakes, nix-command, recursive-nix, pipe-operator) | 2. Installs nix with some experimental features (flakes, nix-command, recursive-nix, pipe-operator) | ||||||
| 3. Runs `nix flake check` on the codebase | 3. Runs `nix flake check` on the codebase | ||||||
| 
 | 
 | ||||||
| ## 📝 Goals and improvements | #### ↪️ `Nix: validate flake.lock` | ||||||
| The main goals of this rewritten flake are: | This workflow can be found in `.github/workflows/validate-lock.yml`. | ||||||
|  | It simply scans flake lockfiles for duplicate entries using `nix run github:tgirlcloud/pkgs#locker`. | ||||||
|  | Under the hood it makes use of the locker lockfile linter, created by the [tgirlcloud](https://github.com/tgirlcloud) team (mostly [isabelroses](https://github.com/isabelroses). | ||||||
| 
 | 
 | ||||||
| - using flake-parts in place of Snowfall lib | To be specific, it does the following: | ||||||
| - significantly improving the re-usability of all modules | 1. Checks out current branch | ||||||
| - avoiding anti-patterns, such as `with lib; with lib.${namespace};` | 2. Installs nix with some experimental features (flakes, nix-command) | ||||||
| - improved secrets management | 3. Runs `nix run github:tgirlcloud/pkgs#locker` on the codebase | ||||||
| - keeping external assets closer to their related nix file, e.g. wallpapers in | 
 | ||||||
| the desktop modules folder | ## 📝 Future goals and improvements (2025-07-28) | ||||||
|  | Some of my future goals for this flake are: | ||||||
|  | 
 | ||||||
|  | - Implementing an automated release workflow with semver versioning, e.g. 2.3.0. | ||||||
|  | - Experimenting with various window-managers, especially Niri, though not set in stone yet. | ||||||
|  | - Researching performance best-practices for hardware and implementing patches based on those. | ||||||
|  | - Further refining my usage of the Nix language, through language best-practices and CLI dev tools. | ||||||
| 
 | 
 | ||||||
| ## 🏗️ Structure | ## 🏗️ Structure | ||||||
| The structure this flake aims to build on is relatively simple to grasp. | The structure this flake aims to build on is relatively simple to grasp. | ||||||
|  | @ -131,5 +135,6 @@ and documentations such as: | ||||||
| 
 | 
 | ||||||
| - [flake-parts](https://flake.parts) | - [flake-parts](https://flake.parts) | ||||||
| - [NixOS and Flakes book](https://nixos-and-flakes.thiscute.world) | - [NixOS and Flakes book](https://nixos-and-flakes.thiscute.world) | ||||||
|  | - [The official NixOS wiki](https://wiki.nixos.org) | ||||||
| 
 | 
 | ||||||
| many thanks to their hard work! | many thanks to their hard work! | ||||||
|  |  | ||||||
		Loading…
	
	Add table
		Add a link
		
	
		Reference in a new issue