Whenever you create or join a project, your user .brev
directory runs, automating the setup of your project.
Fork and modify this template to add your own custom user settings. For project specific settings, see the project .brev
template repository.
A. Replace .vscode/settings.json
with your personal VSCode settings.json
.
To locate your personal VSCode
settings.json
, first open VSCode. Then click Cmd+Shft+P (Ctrl+Shft+P for Windows) and typePreferences: Open Settings (JSON)
.
B. Open .brev/setup.sh
and add your VSCode extensions.
To find an extension id, click the settings icon on any extension card and click
Copy Extension ID
A. Replace .zshrc
with your personal .zshrc
. If you use bash, replace .bash_profile
instead!
Not sure if you have zsh? Type in
zsh --version
to check. To get your personal terminal settings, type incat ~/.zshrc
orcat ~/.bash_profile
. If you have any files you want to reference in this script, add them to the.brev/utils
folder and reference them as/home/brev/workspace/.brev/utils/<FILENAME>
.
B. If you use bash, comment out the code under ##### MAKE ZSH DEFAULT #####
in .brev/setup.sh
.
Specifically lines 47 - 53.
If there are other tools you'd like to install globally (this means they are downloaded everytime you create or join a project), add them in .brev/setup.sh
. For example, this is where we add zsh!
Done! Happy coding!
If you want to adjust these for more custom setups, here's more information on how this configuration repository is structured.
This is our main configuration folder. This is run everytime you create or join a new project. There is also a project specific dot brev with the same structure, which holds software that you can download for each project.
This is the main configuration file that runs on your linux machine, directly after we provision it and before your project is cloned.
You can pre-download VSCode extensions and globally install software like zsh, linux build tools, or create-react-app. Anything that you would globally install on your computer. The working directory when the file is running is /home/brev/user-dotbrev.
Careful not to place too many software packages in here (like Node v14, Python, or Go), and instead place that in your project's .brev
. This way different versions of your software will not conflict, and others can clone your environment.
This is where we keep logs that occur when running the setup script and cloning repositories (such as this one, and your project repository if you are creating or joining a project from git).
This is where we keep any other files that you'd like to include in your .bash_profile
or your .zshrc
. We port this folder to each workspace. References will always be /home/brev/workspace/.brev/utils/<FILENAME>
. Ex. git-completion.bash
runs if you use our recommended .bash_profile
settings.
This should be replaced with your bash profile or your zshrc. We use this to setup aliases, git completion or any other terminal specific settings you have for your terminal.
We have recommended aliases and git completion if you want to uncomment those lines. Again, any other files you'd like to reference should be in /home/brev/workspace/user-dotbrev/.brev/utils/<FILENAME>
.
This file is copied into our fork of VSCode so your settings are the same.