README.md

dotfiles (~/.)

New Computer Setup

First install Oh-my-zsh, then clone this repo and run the install script.

gh repo clone thrivingproject/dotfiles ~/.dotfiles
cd .dotfiles
bash local-install.sh

Local VS Code devcontainer dotfiles incorporation

Modify VS Code Dev Containers extension's Dotfiles settings to use dotfiles from this repo. Use install-local.sh as the value for the install command field. Do not sync these settings so that settings sync can still be used with codespaces without interfering with codespaces' own dotfiles setup.

See VSCode devcontainer docs for more information.

Codespaces dotfiles incorporation

Change GitHub settings to automatically install dotfiles when creating a codespace. Codespaces should not use the ./local-install.sh script to setup the environment so that it can put the files where it needs them. It will replace the default dotfiles with the ones in this repo.

See GitHub codespaces docs form more information.

Environment variables, API Keys, secrets

Using local environment variables in devcontainers

Export variables to environment using .zprofile. This is safe because .zprofile is not a part of this repository. Then add the containerEnv property to devcontainer.json per advanced container docs.

Using secrets in codespaces

Use the secrets tool in codespaces settings.

Git

Account configuration (credentials) is only needed when using devcontainers locally. Dev Containers will automatically copy local .gitignore to the container. gitignore_global is included and installed by this repo.

Note: no git config command should be executed from the install script, because this will create a .gitconfig file in the home directory, which will cause devcontainers to skip copying the local .gitignore file to the container (see the dev.containers.copyGitConfig setting in VS Code).