feat: add snapcraft packaging and documentation

Author: alfespa17

.gitignore

@@ -14,4 +14,11 @@
 
 # Dependency directories (remove the comment below to include it)
 # vendor/
-terrakube
+terrakube
+
+# Snapcraft build artifacts
+*.snap
+.craft/
+parts/
+prime/
+stage/

README.md

@@ -7,11 +7,15 @@ For full CLI reference documentation, visit our official guide at [https://docs.
 ## Table of Contents
 
 - [Download & Installation](#download--installation)
-- [Adding Terrakube CLI to PATH](#adding-terrakube-cli-to-path)
+  - [Snap Package (Ubuntu / Linux)](#snap-package-ubuntu--linux)
   - [Linux & macOS](#linux--macos)
   - [Windows](#windows)
+- [Adding Terrakube CLI to PATH](#adding-terrakube-cli-to-path)
+  - [Linux & macOS](#linux--macos-1)
+  - [Windows](#windows-1)
 - [Building & Testing from Source](#building--testing-from-source)
   - [Compiling the Binary](#compiling-the-binary)
+  - [Building Snap Package Locally](#building-snap-package-locally)
   - [Running Unit Tests](#running-unit-tests)
   - [Running End-to-End (BATS) Tests](#running-end-to-end-bats-tests)
 - [Quick Start Guide](#quick-start-guide)
@@ -28,7 +32,22 @@ For full CLI reference documentation, visit our official guide at [https://docs.
 
 ## Download & Installation
 
-You can download pre-compiled binaries directly from our [GitHub Releases](https://github.com/terrakube-io/terrakube-cli/releases/latest) page.
+You can download pre-compiled binaries directly from our [GitHub Releases](https://github.com/terrakube-io/terrakube-cli/releases/latest) page, or install via Snap on Linux/Ubuntu.
+
+### Snap Package (Ubuntu / Linux)
+
+You can install the local `.snap` package:
+
+```bash
+sudo snap install --dangerous terrakube-cli_*.snap
+```
+
+Both `terrakube` and `terrakube-cli` commands will be available:
+
+```bash
+terrakube --version
+terrakube-cli --help
+```
 
 ### Linux & macOS (Bash / Zsh)
 
@@ -141,6 +160,29 @@ Verify compilation:
 ./terrakube --help
 ```
 
+### Building Snap Package Locally
+
+To build the Snap package on Ubuntu/Linux:
+
+1. Install `snapcraft`:
+   ```bash
+   sudo snap install snapcraft --classic
+   ```
+
+2. Build the snap:
+   ```bash
+   # Build directly in container (LXD/Multipass):
+   snapcraft
+
+   # Or build locally in destructive mode:
+   snapcraft --destructive-mode
+   ```
+
+3. Install the locally generated `.snap` package:
+   ```bash
+   sudo snap install --dangerous terrakube-cli_*.snap
+   ```
+
 ### Running Unit Tests
 
 Run unit tests across all Golang packages:

snap/snapcraft.yaml

@@ -0,0 +1,39 @@
+name: terrakube-cli
+title: Terrakube CLI
+base: core24
+version: '0.5.0'
+summary: CLI tool for Terrakube
+description: |
+  terrakube is a CLI tool to handle remote Terraform workspaces and modules
+  in Terrakube organizations, managing the full execution lifecycle (plan, apply, destroy).
+license: Apache-2.0
+website: https://terrakube.io
+contact: https://github.com/terrakube-io/terrakube-cli/issues
+issues: https://github.com/terrakube-io/terrakube-cli/issues
+source-code: https://github.com/terrakube-io/terrakube-cli
+
+grade: stable
+confinement: strict
+
+apps:
+  terrakube-cli:
+    command: bin/terrakube
+    plugs:
+      - home
+      - network
+      - removable-media
+  terrakube:
+    command: bin/terrakube
+    plugs:
+      - home
+      - network
+      - removable-media
+
+parts:
+  terrakube-cli:
+    plugin: go
+    source: .
+    build-snaps:
+      - go/latest/stable
+    override-build: |
+      go build -ldflags="-s -w" -o "${CRAFT_PART_INSTALL}/bin/terrakube" .