2 files changed, 38 insertions, 4 deletions
diff --git a/docs/getting-started/nix.md b/docs/getting-started/nix.md
index f09a80b..2b04bdc 100644
--- a/docs/getting-started/nix.md
+++ b/docs/getting-started/nix.md
@@ -11,8 +11,8 @@ Using Astal on Nix will require you to package your project.
   inputs = {
     nixpkgs.url = "github:nixos/nixpkgs/nixos-unstable";
     astal = {
-      inputs.nixpkgs.follows = "nixpkgs";
       url = "github:aylur/astal";
+      inputs.nixpkgs.follows = "nixpkgs";
     };
   };
 
@@ -39,7 +39,39 @@ Using Astal on Nix will require you to package your project.
 ```
 
 ```nix [<i class="devicon-vala-plain"></i> Vala]
-# Not documented yet
+# keep in mind that this is just the nix derivation
+# and you still have to use some build tool like meson
+{
+  inputs = {
+    nixpkgs.url = "github:nixos/nixpkgs/nixos-unstable";
+    astal.url = "github:aylur/astal";
+  };
+
+  outputs = { self, nixpkgs, astal }: let
+    system = "x86_64-linux";
+    pkgs = nixpkgs.legacyPackages.${system};
+  in {
+    packages.${system} = {
+      default = pkgs.stdenv.mkDerivation {
+        name = "my-shell";
+        src = ./.;
+
+        nativeBuildInputs = with pkgs; [
+          meson
+          ninja
+          pkg-config
+          vala
+          gobject-introspection
+        ];
+
+        # add extra packages
+        buildInputs = [
+          astal.packages.${system}.astal
+        ];
+      };
+    };
+  };
+}
 ```
 
 :::
diff --git a/docs/getting-started/supported-languages.md b/docs/getting-started/supported-languages.md
index 88ec93f..06ce51c 100644
--- a/docs/getting-started/supported-languages.md
+++ b/docs/getting-started/supported-languages.md
@@ -42,7 +42,8 @@ Examples:
 ## Vala
 
 Vala is a language that simply put uses C# syntax and compiles to C.
-It is the language most of Astal is written in.
+It is the language most of Astal is written in. I would still recommend
+using TypeScript or Lua over Vala as they don't need a build step.
 
 Examples:
 
@@ -51,7 +52,8 @@ Examples:
 
 ## C
 
-I don't recommend using C as it requires quite a lot of boilerplate.
+I don't recommend using C as it requires quite a lot of boilerplate, both for
+build step and code.
 
 Examples: