An open API service indexing awesome lists of open source software.

https://github.com/traap/bootstrap-win-env

Bootstrap a minimal LaTeX, Ruby, and NeoVim on Windows 11.
https://github.com/traap/bootstrap-win-env

Last synced: 3 months ago
JSON representation

Bootstrap a minimal LaTeX, Ruby, and NeoVim on Windows 11.

Awesome Lists containing this project

README

          

# ๐Ÿš€ Windows 11 Dev Environment Installer

This repository provides a reproducible Windows 11 development environment using
a single `install.cmd` script. It installs all tools using `winget` and runs
under **Command Prompt with administrative privileges**.
---
## โš ๏ธ TL;DR

Quick steps:
1. Start a Git Bash shell and clone this repository
```cmd
git clone http://github.com/Traap/bootstrap-win-env
cd your-repo
```
2. Change USERROOT in ```user-environment-variabvles.cfg```
3. Start a command shell and run these commands
```command
set-user-environment-variables.cmd
set-user-path.cmd replace_userj
install.cmd
```
4. Logout; your system is ready. FYI: Check for a valid .bashrc
5. Start a Git Bash Shell to clone respositories and build documentation
```
gits clone -v
cd $AUTODOCPATH
docbld list_files
docbld
`
---

## ๐Ÿ”ง Requirements

- โœ… Windows 11 (with `winget` v1.4+ or newer)
- โœ… Run from **Command Prompt as Administrator**
- โŒ Does *not* use PowerShell
- โœ… Git and system PATH correctly configured
- โœ… UTF-8/CRLF line endings enforced via `.gitattributes`

---

## ๐Ÿ“ฆ Tools Installed

The script installs:

- Git
- Ruby (with DevKit)
- MiKTeX LaTeX
- Neovim
- SumatraPDF
- Visual Studio Code
- Python 3
- Traap/gits CLI

---

## โ–ถ๏ธ How to Use

1. Open **Command Prompt as Administrator**
2. Clone this repo:
```cmd
git clone https://github.com/your-user/your-repo.git
cd your-repo
```
3. Run the installer:
```cmd
install.cmd
```

---

## โš™๏ธ Post-Install Notes

- Ruby includes `rake` via `gem install`
- Python is installed with virtual environment support
- `gits` CLI is cloned into `%USERPROFILE%\gits` and installed into a virtualenv
- Visual Studio Code installs several extensions (e.g., Ruby, LaTeX, Neovim)

---

## ๐Ÿช“ Uninstall

To uninstall everything, use the included `uninstall.cmd`:
```cmd
uninstall.cmd
```

- Supports `/dry-run` and logs to `uninstall.log`
- Prompts for confirmation before proceeding

---

## ๐Ÿงช Troubleshooting

- Ensure script line endings are **CRLF**
- Run:
```cmd
where winget
```
If not found in admin shell, add this to system PATH:
```
%LocalAppData%\Microsoft\WindowsApps
```

---

## ๐Ÿ“„ License
BSD 3-Clause License