{"id":27958415,"url":"https://github.com/determinatesystems/flake-schemas","last_synced_at":"2025-05-07T18:23:30.770Z","repository":{"id":191671502,"uuid":"671886247","full_name":"DeterminateSystems/flake-schemas","owner":"DeterminateSystems","description":"Schemas for common flake output types","archived":false,"fork":false,"pushed_at":"2025-04-18T23:54:09.000Z","size":83,"stargazers_count":90,"open_issues_count":11,"forks_count":6,"subscribers_count":11,"default_branch":"main","last_synced_at":"2025-05-01T15:44:17.356Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Nix","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DeterminateSystems.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2023-07-28T11:19:07.000Z","updated_at":"2025-04-18T23:54:11.000Z","dependencies_parsed_at":"2024-06-28T14:08:54.175Z","dependency_job_id":"cdd28341-b66b-463a-9882-c270c98d8772","html_url":"https://github.com/DeterminateSystems/flake-schemas","commit_stats":null,"previous_names":["determinatesystems/flake-schemas"],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DeterminateSystems%2Fflake-schemas","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DeterminateSystems%2Fflake-schemas/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DeterminateSystems%2Fflake-schemas/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DeterminateSystems%2Fflake-schemas/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DeterminateSystems","download_url":"https://codeload.github.com/DeterminateSystems/flake-schemas/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252932267,"owners_count":21827266,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-05-07T18:23:30.055Z","updated_at":"2025-05-07T18:23:30.760Z","avatar_url":"https://github.com/DeterminateSystems.png","language":"Nix","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Flake schemas\n\n\u003e [!NOTE]\n\u003e Flake schemas are not yet supported in Nix.\n\u003e You can track ongoing work in [this pull request][pr] against the upstream project.\n\u003e Until that merges, you may see this warning:\n\u003e\n\u003e ```sh\n\u003e warning: unknown flake output 'schemas'\n\u003e ```\n\u003e\n\u003e You can also [experiment with flake schemas](#experimenting-with-flake-schemas) using a candidate version of Nix.\n\nThis [Nix flake][flakes] provides a set of schema definitions for commonly used flake output types.\nIt's used by default for flakes that do not have a `schemas` output.\n\nIt supports the following flake output types:\n\n* [`apps`][apps]\n* [`checks`][checks]\n* [`darwinConfigurations`][darwin]\n* [`darwinModules`][darwin]\n* [`devShells`][develop]\n* [`dockerImages`][docker]\n* [`formatter`][formatter]\n* [`homeConfigurations`][home]\n* [`homeModules`][home]\n* [`hydraJobs`][hydra]\n* [`legacyPackages`][legacy]\n* [`nixosConfigurations`][nixos]\n* [`nixosModules`][nixosmodules]\n* [`overlays`][overlays]\n* [`packages`][packages]\n* `schemas`\n* [`templates`][templates]\n\n## Experimenting with flake schemas\n\nFlake schemas are not yet supported in Nix.\nTo experiment with them, you can use the version of Nix from the [pull request][pr] to upstream.\nBelow are some example commands.\n\n\u003e [!WARNING]\n\u003e The first time you run one of the commands, you will build Nix in its entirety, which is resource intensive and could take a while.\n\n```shell\n# Display the flake schema for this repo\nnix run github:DeterminateSystems/nix-src/flake-schemas -- \\\n  flake show \"https://flakehub.com/f/DeterminateSystems/flake-schemas/*\"\n\n# Display the flake schema for this repo as JSON\nnix run github:DeterminateSystems/nix-src/flake-schemas -- \\\n  flake show --json \"https://flakehub.com/f/DeterminateSystems/flake-schemas/*\"\n\n# Display the flake schema for Nixpkgs\nnix run github:DeterminateSystems/nix-src/flake-schemas -- \\\n  flake show \"https://flakehub.com/f/NixOS/nixpkgs/*\"\n\n# Display the flake schema for Nixpkgs as JSON\nnix run github:DeterminateSystems/nix-src/flake-schemas -- \\\n  flake show --json \"https://flakehub.com/f/NixOS/nixpkgs/*\"\n```\n\n## Read more\n\n- [Flake schemas: Making flake outputs extensible][blog] \u0026mdash; the blog post introducing flake schemas.\n- [Flake schemas][video] \u0026mdash; [Eelco Dolstra][eelco]'s talk on flake schemas at [NixCon 2023][nixcon-2023].\n\n[apps]: https://nix.dev/manual/nix/latest/command-ref/new-cli/nix3-run#apps\n[blog]: https://determinate.systems/posts/flake-schemas\n[branch]: https://github.com/DeterminateSystems/nix-src/tree/flake-schemas\n[checks]: https://nixos.org/manual/nix/stable/command-ref/new-cli/nix3-flake-check.html\n[darwin]: https://github.com/LnL7/nix-darwin\n[docker]: https://nixos.org/manual/nixpkgs/stable/#sec-pkgs-dockerTools\n[develop]: https://nixos.org/manual/nix/stable/command-ref/new-cli/nix3-develop.html\n[eelco]: https://determinate.systems/people/eelco-dolstra\n[flakes]: https://zero-to-nix.com/concepts/flakes\n[formatter]: https://nix.dev/manual/nix/latest/command-ref/new-cli/nix3-fmt\n[home]: https://github.com/nix-community/home-manager\n[hydra]: https://github.com/NixOS/hydra\n[legacy]: https://github.com/NixOS/nixpkgs/blob/d1eaf1acfce382f14d26d20e0a9342884f3127b0/flake.nix#L47-L56\n[nixcon-2023]: https://2023.nixcon.org\n[nixos]: https://github.com/NixOS/nixpkgs/tree/master/nixos\n[nixosmodules]: https://nixos.wiki/wiki/NixOS_modules\n[overlays]: https://nixos.wiki/wiki/Overlays\n[packages]: https://search.nixos.org/packages\n[pr]: https://github.com/NixOS/nix/pull/8892\n[templates]: https://nix.dev/manual/nix/latest/command-ref/new-cli/nix3-flake-init\n[video]: https://www.youtube.com/watch?v=ChaJY0V4ElM\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeterminatesystems%2Fflake-schemas","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdeterminatesystems%2Fflake-schemas","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeterminatesystems%2Fflake-schemas/lists"}