====== MacOS ======

=== Setting up your environment ===

Folk is built on [[https://wiki.tcl-lang.org/|Tcl]], so you'll need to install the latest version for 'folk' to work correctly. MacOS has a version of ''tcl-tk'' installed by default but you [[https://www.python.org/download/mac/tcltk/#:~:text=A%20built%2Din%20version%20of,use%20the%20Apple%2Dsupplied%20Pythons.|really shouldn't use it because it's riddled with bugs and warnings]]. Let's get you set up with the latest version of Tcl <sup>(as of June 2025)</sup>:

  - Download the latest [[https://formulae.brew.sh/formula/tcl-tk|tcl-tk]] from [[https://brew.sh/|Homebrew]]:
    * <code bash>
# In your terminal:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# and then run this:
brew install tcl-tk
</code>
  - Set your [[https://wiki.tcl-lang.org/page/TCL_LIBRARY|TCL_LIBRARY]] and [[https://wiki.tcl-lang.org/page/TCLLIBPATH|TCLLIBPATH]] variables in your ''.bashrc'', ''.zshrc'', or similar:
    * <code bash>
# in your .bashrc, .zshrc, etc.:
export PATH="/opt/homebrew/bin:$PATH"
export TCL_LIBRARY="/opt/homebrew/lib/tcl8.6"
export TCLLIBPATH="/opt/homebrew/lib"
</code>
  - Restart your terminal or ''source'' you config file, e.g. ''source .zshrc''
  - Test that you've installed ''tclsh8.6'' correctly on MacOS by running this:
    * <code bash>
# In your command line run:
echo 'puts $tcl_version;exit 0' | tclsh
9.0
# ↑ Expected output, 9.0 or higher
</code>
  - TODO ...