https://github.com/iogamaster/tide

🌊 Unified Framework for NixOS configurations using flakes
https://github.com/iogamaster/tide

configuration deployment flake framework nix nixos

Last synced: about 1 year ago
JSON representation

🌊 Unified Framework for NixOS configurations using flakes

• Host: GitHub
• URL: https://github.com/iogamaster/tide
• Owner: IogaMaster
• License: mit
• Created: 2024-12-30T21:58:07.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-12-30T22:29:08.000Z (over 1 year ago)
• Last Synced: 2024-12-30T23:22:59.806Z (over 1 year ago)
• Topics: configuration, deployment, flake, framework, nix, nixos
• Homepage:
• Size: 3.91 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

          
🌊 tide






  
 


  


    

        

    

    

        

    

    

        

    

    

        

    

    


    

        

   

   


With tide you can build a NixOS configuration with integration with builtin deployment (using colmena), simple patch application, multi-file flake.nix and more!

- ✨  Magic

    - Flake inputs can be full nix code (using [flakegen](https://github.com/jorsn/flakegen))

    - Autowiring of outputs using [haumea](https://github.com/nix-community/haumea)

- ⚙️  Tons of utilities and features:

    - Fully integrated with [colmena](https://github.com/zhaofengli/colmena) for deployment and updates

    - Automatic updates of systems with [comin](https://github.com/nlewo/comin)

    - Better hardware config using [nixos-facter](https://github.com/numtide/nixos-facter)

    - Simple installs using [nixos-anywhere](https://github.com/nix-community/nixos-anywhere)

- 📦 Builtin cli tools

    

    

#### Why?

[Snowfall Lib](https://github.com/snowfallorg/lib) is a fantastic project, so i was inspired to make a more simple and all in one framework myself.

## 📦 Installation and Usage

### Getting Started:

Use the template located at: https://github.com/iogamaster/tide-template

```shell

mkdir myconfig && cd myconfig

nix flake init -t github:iogamaster/tide-template

```

Read the getting started guide here:

[getting-started.md](./docs/getting-started.md)

## 🔨 TODO

There is still a lot to do:

- Finish the basic `mkFlake` function

- Add a terraform setup

- Write proper documentation for tide, and the template

- darwin support

## ❤️ Contributing

Contributions are whole-heartedly welcome! Please feel free to suggest new features,

implement additional builders, helpers, or generally assist if you'd like. We'd be happy to have you.

There's more information in [CONTRIBUTING.md](CONTRIBUTING.md).

## 📜 License

Licensed under the MIT license ([LICENSE](LICENSE) or ).

Unless you explicitly state otherwise, any contribution intentionally

submitted for inclusion in this project by you, shall be licensed as above, without any additional terms or conditions.