Navid's Unofficial Local Dev Guide

# Add direnv hook to .zshrc
echo 'eval "$(direnv hook zsh)"' >> ~/.zshrc

# Create direnv config directory
mkdir -p ~/.config/direnv

# Create direnv configuration file
cat > ~/.config/direnv/direnv.toml << 'EOF'
[global]
# don't display large env diff on cd
hide_env_diff = true

[whitelist]
# don't require direnv allow on whitelisted dir
prefix = [ "~/projects/" ]
EOF

# Install Oh My Zsh (interactive installer)
sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

# Install Powerlevel10k theme
git clone --depth=1 https://github.com/romkatv/powerlevel10k.git ${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k

# Install recommended font (optional but recommended)
brew tap homebrew/cask-fonts
brew install --cask font-meslo-lg-nerd-font

# Install zsh-autosuggestions
git clone https://github.com/zsh-users/zsh-autosuggestions ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions

# Install zsh-syntax-highlighting
git clone https://github.com/zsh-users/zsh-syntax-highlighting.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting

# Install z (directory jumper)
brew install z

cp ~/.zshrc ~/.zshrc.backup

# ~/.zshrc
# Enable Powerlevel10k instant prompt. Should stay close to the top of ~/.zshrc.
# Initialization code that may require console input (password prompts, [y/n]
# confirmations, etc.) must go above this block; everything else may go below.
if [[ -r "${XDG_CACHE_HOME:-$HOME/.cache}/p10k-instant-prompt-${(%):-%n}.zsh" ]]; then
  source "${XDG_CACHE_HOME:-$HOME/.cache}/p10k-instant-prompt-${(%):-%n}.zsh"
fi

# Suppress Powerlevel10k instant prompt warning for direnv output
# This prevents the warning about console output during initialization
typeset -g POWERLEVEL9K_INSTANT_PROMPT=quiet

# Path configuration
export PATH=$HOME/bin:/usr/local/bin:$PATH
export PATH="/opt/homebrew/opt/libpq/bin:$PATH"
export PATH=$PATH:/Applications/Postgres.app/Contents/Versions/15/bin
export PATH="/opt/homebrew/opt/openssl@3/bin:$PATH"

# Oh My Zsh configuration
export ZSH="$HOME/.oh-my-zsh"

# Use Powerlevel10k theme for better prompts
ZSH_THEME="powerlevel10k/powerlevel10k"

# Productive plugins
plugins=(
    git                    # Git aliases and functions
    z                      # Jump to frequently used directories
    zsh-autosuggestions    # Fish-like autosuggestions
    zsh-syntax-highlighting # Fish-like syntax highlighting
    direnv                 # Auto-load .envrc files
    docker                 # Docker completions
    docker-compose         # Docker compose completions
    kubectl                # Kubernetes completions
    aws                    # AWS CLI completions
    terraform              # Terraform completions
    npm                    # NPM completions
    python                 # Python completions
    pip                    # Pip completions
    history                # Better history search
    colored-man-pages      # Colorized man pages
    command-not-found      # Suggest package to install
    extract                # Extract any archive with 'x'
)

# Performance optimizations
DISABLE_UNTRACKED_FILES_DIRTY="true"  # Faster git status in large repos
COMPLETION_WAITING_DOTS="true"         # Show dots while waiting for completion
HIST_STAMPS="yyyy-mm-dd"              # Better history timestamps

source $ZSH/oh-my-zsh.sh

# Better history configuration
HISTSIZE=50000
SAVEHIST=50000
setopt EXTENDED_HISTORY          # Write the history file in the ":start:elapsed;command" format
setopt INC_APPEND_HISTORY        # Write to the history file immediately, not when the shell exits
setopt SHARE_HISTORY             # Share history between all sessions
setopt HIST_EXPIRE_DUPS_FIRST    # Expire duplicate entries first when trimming history
setopt HIST_IGNORE_DUPS          # Don't record an entry that was just recorded again
setopt HIST_IGNORE_ALL_DUPS      # Delete old recorded entry if new entry is a duplicate
setopt HIST_FIND_NO_DUPS         # Do not display a line previously found
setopt HIST_IGNORE_SPACE         # Don't record an entry starting with a space
setopt HIST_SAVE_NO_DUPS         # Don't write duplicate entries in the history file
setopt HIST_REDUCE_BLANKS        # Remove superfluous blanks before recording entry

# Better directory navigation
setopt AUTO_CD              # Go to folder without typing cd
setopt AUTO_PUSHD           # Push the current directory on the stack
setopt PUSHD_IGNORE_DUPS    # Don't push multiple copies of the same directory
setopt PUSHD_MINUS          # Exchange meanings of + and -

# Aliases - Git (extending the git plugin)
alias gs='git status -sb'
alias gp='git pull --rebase'
alias gpu='git push'
alias gco='git checkout'
alias gcb='git checkout -b'
alias glog='git log --oneline --graph --decorate -10'
alias gdiff='git diff --stat'
alias gstash='git stash push -m'
alias gunstash='git stash pop'

# Aliases - Canary development
alias croot='cd ~/projects/canary'
alias cback='cd ~/projects/canary/backend'
alias ccan='cd ~/projects/canary/backend/canary'
alias cpms='cd ~/projects/canary/backend/pms-gateway'
alias cfront='cd ~/projects/canary/frontend'
alias cshared='cd ~/projects/canary/backend/shared'

# Aliases - Python/Django
alias pm='direnv exec . python manage.py'
alias pms='direnv exec . python manage.py shell_plus'
alias pmm='direnv exec . python manage.py migrate'
alias pmmm='direnv exec . python manage.py makemigrations'
alias pytest='direnv exec . python -m pytest'

# Productivity aliases
alias ll='ls -alFh'
alias la='ls -A'
alias l='ls -CF'
alias ..='cd ..'
alias ...='cd ../..'
alias ....='cd ../../..'
alias mkdir='mkdir -pv'
alias grep='grep --color=auto'
alias top='htop'

# Quick edit configs
alias zshrc='${EDITOR:-nano} ~/.zshrc && source ~/.zshrc'
alias vimrc='${EDITOR:-nano} ~/.vimrc'
alias gitconfig='${EDITOR:-nano} ~/.gitconfig'

# direnv configuration
export DIRENV_LOG_FORMAT=""
eval "$(direnv hook zsh)"

# Canary CLI function
canary () {
    nix run "git+ssh://git@github.com/canary-technologies-corp/canary-cli" -- "$@"
}

# Quick directory jump function for Canary monorepo
c() {
    case "$1" in
        root) cd ~/projects/canary ;;
        back|backend) cd ~/projects/canary/backend/canary ;;
        pms) cd ~/projects/canary/backend/pms-gateway ;;
        front|frontend) cd ~/projects/canary/frontend ;;
        shared) cd ~/projects/canary/backend/shared ;;
        scripts) cd ~/projects/canary/scripts ;;
        docs) cd ~/projects/canary/docs ;;
        tf|terraform) cd ~/projects/canary/terraform ;;
        *) echo "Unknown location: $1" ;;
    esac
}

# Function to quickly search code in the monorepo
search() {
    if [[ -z "$1" ]]; then
        echo "Usage: search <pattern>"
        return 1
    fi
    rg --smart-case --hidden --glob '!.git' --glob '!node_modules' --glob '!.venv' --glob '!__pycache__' "$@"
}

# FZF integration for better file/history search
[ -f ~/.fzf.zsh ] && source ~/.fzf.zsh

# Set default editor
export EDITOR='nano'
export VISUAL='nano'

# Canary directory
export CANARY_DIR="$HOME/projects/canary"

# Load Powerlevel10k configuration if it exists
[[ ! -f ~/.p10k.zsh ]] || source ~/.p10k.zsh

source ~/.zshrc

# Configure Git user information
git config --global user.name "Your Name"
git config --global user.email "your.email@canarytechnologies.com"

# Enable credential caching
git config --global credential.helper osxkeychain

# Automatically set up remote tracking branches
git config --global push.autoSetupRemote true

ssh-keygen -t ed25519 -C "your.email@canarytechnologies.com" -f ~/.ssh/id_ed25519

ssh-add ~/.ssh/id_ed25519

pbcopy < ~/.ssh/id_ed25519.pub

ssh -T git@github.com

# Navigate to Canary directory
cd ~/projects/canary

# Set up local AWS access
canary aws local-access-setup

# Verify AWS access is working
canary aws app-login

# After downloading, place the override file in the Canary backend directory
cp ~/Downloads/docker-compose.override.yml ~/projects/canary/backend/canary/

# Verify the file is in place
cat ~/projects/canary/backend/canary/docker-compose.override.yml

# This override file configures:
# - PostgreSQL: port 5433 → 5432 (standard port)
# - Redis: port 6380 → 6379 (standard port)

# Navigate to Canary backend directory
cd ~/projects/canary/backend/canary

# Start Redis service (will use port 6379 from override file)
docker compose up --wait redis

# Verify Redis is running
docker compose exec redis redis-cli ping
# Should output: PONG

# Test Redis connection from Python
cd ~/projects/canary/backend/canary
source .venv/bin/activate
python -c "import redis; r = redis.Redis(host='localhost', port=6379, db=0); print('Redis connected:', r.ping())"
# Should output: Redis connected: True

# Navigate to Canary backend directory
cd ~/projects/canary/backend/canary

# Start LocalStack service
docker compose up --wait localstack

# Create the delivery FIFO queue
docker compose exec localstack awslocal sqs create-queue --queue-name "delivery.fifo" --attributes "FifoQueue=true"

# Verify the queue was created
docker compose exec localstack awslocal sqs list-queues

# Install native dependencies
cd ~/projects/canary/backend/canary
yes | bash ../../scripts/install_dyld.sh

# This script:
# - Finds libmagic and cairo libraries installed via Nix
# - Creates symbolic links in /usr/local/lib so Python can find them
# - Requires sudo password to write to /usr/local/lib
# - The 'yes' command auto-confirms overwriting existing links

# Create Python virtual environment
cd ~/projects/canary/backend/canary
uv venv --seed

# Activate virtual environment and install Python dependencies
cd ~/projects/canary/backend/canary
source .venv/bin/activate
uv pip sync requirements*.txt

# Run migrations for all Canary databases
cd ~/projects/canary/backend/canary
source .venv/bin/activate

# Run migrations in parallel
python manage.py migrate &
python manage.py migrate --database=event &
python manage.py migrate --database=vector &
python manage.py migrate --database=crs_gateway &
wait

# Build frontend components
cd ~/projects/canary/frontend-components
pnpm --version
pnpm i
pnpm build

# Create cache table (might already exist from dump)
cd ~/projects/canary/backend/canary
source .venv/bin/activate
python manage.py createcachetable || true

# Create Django superuser
cd ~/projects/canary/backend/canary
source .venv/bin/activate
echo "from django.contrib.auth import get_user_model; User = get_user_model(); User.objects.create_superuser('root', 'root@example.com', 'root') if not User.objects.filter(username='root').exists() else None" | python manage.py shell

# Start Django development server
cd ~/projects/canary/backend/canary
source .venv/bin/activate
python manage.py runserver

# Server will start at http://localhost:8000
# Visit http://localhost:8000/canary-admin to access the Django admin
# Login with username: root, password: root

# Create Python virtual environment for PMS Gateway
cd ~/projects/canary/backend/pms-gateway
uv venv --seed

# Install PMS Gateway Python dependencies
cd ~/projects/canary/backend/pms-gateway
source .venv/bin/activate
uv pip sync requirements*.txt

# Run PMS Gateway migrations
cd ~/projects/canary/backend/pms-gateway
source .venv/bin/activate
python manage.py migrate

# Create cache table for PMS Gateway (might already exist from dump)
cd ~/projects/canary/backend/pms-gateway
source .venv/bin/activate
python manage.py createcachetable || true

# Create Django superuser for PMS Gateway
cd ~/projects/canary/backend/pms-gateway
source .venv/bin/activate
echo "from django.contrib.auth import get_user_model; User = get_user_model(); User.objects.create_superuser('root', 'root@example.com', 'root') if not User.objects.filter(username='root').exists() else None" | python manage.py shell

# Start PMS Gateway development server
cd ~/projects/canary/backend/pms-gateway
source .venv/bin/activate
python manage.py runserver 0.0.0.0:8001

# Server will start at http://localhost:8001
# Visit http://localhost:8001/admin to access the Django admin
# Login with username: root, password: root
# Note: PMS Gateway runs on port 8001 (Canary uses 8000)

open -a 'Cloudflare WARP'

open -a '1Password'

softwareupdate --list

softwareupdate --install --all

cd ~/projects/canary/backend/canary && python manage.py load_kiosk_fixtures

cd ~/projects/canary/backend/pms-gateway && python manage.py load_kiosk_fixtures

cd ~/projects/canary && cat > setup-kubeconfig.sh << 'EOF'
#!/bin/zsh

gen_kubeconfig() {
  # Generate kubeconfig with the given parameters
  local account=$1
  local region=$2
  local profile=$3

  AWS_PROFILE=$profile aws eks update-kubeconfig --alias $account-main-$region --name main-$region --region $region
}

for region in eu-central-1 us-west-2 ap-southeast-1; do
  for env in stg prd; do
    case $env in
      "stg")
        if [[ $region == "us-west-2" ]]; then
          gen_kubeconfig $env $region canary-$env-shell-plus-readwrite
        fi
        ;;
      "prd")
        gen_kubeconfig $env $region canary-$env-shell-plus-readwrite
        ;;
    esac
  done
done
EOF
chmod +x setup-kubeconfig.sh && ./setup-kubeconfig.sh

k9s