Add page.

README.md

@@ -1,18 +1,47 @@
-# Lukaszraczylo Brew-taps
+# Homebrew Tap
 
-## How do I install these formulae?
+Custom Homebrew tap for macOS and Linux tools by Lukasz Raczylo.
 
-`brew install lukaszraczylo/homebrew-taps/<formula>`
+## Available Casks
 
-Or `brew tap lukaszraczylo/homebrew-taps` and then `brew install <formula>`.
+| Cask | Description |
+|------|-------------|
+| [kportal](https://github.com/lukaszraczylo/kportal) | Modern Kubernetes port-forward manager with interactive TUI |
+| [lolcathost](https://github.com/lukaszraczylo/lolcathost) | Dynamic hosts file manager with interactive terminal UI |
+| [semver-generator](https://github.com/lukaszraczylo/semver-generator) | Automatic semantic version generator based on git commit messages |
 
-Or, in a `brew bundle` `Brewfile`:
+## Installation
+
+### Add the tap
+
+```bash
+brew tap lukaszraczylo/taps
+```
+
+### Install a cask
+
+```bash
+brew install --cask lukaszraczylo/taps/<cask-name>
+```
+
+Or install directly:
+
+```bash
+brew install --cask lukaszraczylo/taps/kportal
+```
+
+### Using Brewfile
+
+Add to your Brewfile:
 
 ```ruby
-tap "lukaszraczylo/homebrew-taps"
-brew "<formula>"
+tap "lukaszraczylo/taps"
+cask "kportal"
+cask "lolcathost"
+cask "semver-generator"
 ```
 
 ## Documentation
 
-`brew help`, `man brew` or check [Homebrew's documentation](https://docs.brew.sh).
+- [Full Documentation](https://lukaszraczylo.github.io/homebrew-taps/)
+- [Homebrew Documentation](https://docs.brew.sh)