···242243---
244245+## Installing Racket
246+247+The standard way to install Racket is via the official installer script at
248+<https://racket-lang.org>. Do NOT use `apt-get install racket` or similar
249+package manager commands — these often install outdated versions from distro
250+repositories.
251+252+### Recommended: Official installer script
253+254+```sh
255+# Download and run the official installer script
256+curl -Ls https://mirror.racket-lang.org/installers/current/racket-current-x86_64-linux-cs.sh \
257+ | sh -s -- --in-place --dest ~/racket
258+export PATH="$HOME/racket/bin:$PATH"
259+```
260+261+Or visit <https://download.racket-lang.org/> to download the installer for your
262+platform (macOS `.dmg`, Windows `.exe`, or Linux `.sh`).
263+264+### macOS
265+266+On macOS, drag the downloaded `.app` into `/Applications`, then add the binaries
267+to your path:
268+269+```sh
270+export PATH="/Applications/Racket v9.0/bin:$PATH"
271+```
272+273+The exact path varies by version number — adjust accordingly.
274+275+### Verifying installation
276+277+```sh
278+racket --version # e.g. "Welcome to Racket v9.0 [cs]."
279+raco --version # should print the same version
280+```
281+282+---
283+284## Project Structure
285286### Single-collection package (most common)