Dotfiles

This repository is managed with chezmoi and contains configuration files for my development environment.

Note

My dev environment is focused on web, mobile and software development, it suits my needs and preferences. You can use this repository as a reference or as a starting point for your own dotfiles. It's up to you to decide what you want to keep or remove and make the necessary adjustments to suit your needs.

Installation guide

Introduction

This README is an opinionated guide to install a clean MacOS development environment.

Important

Everytime you are prompted to setup a passphrase or password, make sure to use a strong and secure one and store it in a secure place. Password managers are a good option to generate and store secure passwords.

Setting up MacOS names

During MacOS setup
- Choose a short, lowercase username.
  
  Example: john → creates /Users/john
- Choose a descriptive, lowercase computer name.
  
  Example: john-personal-mbp
After MacOS setup
- Settings > General > About > Name = john-personal-mbp
- Settings > General > Sharing > LocalHostName = john-personal-mbp
- Set all names explicitly via Terminal:
```
sudo scutil --set ComputerName "john-personal-mbp"
sudo scutil --set LocalHostName "john-personal-mbp"
sudo scutil --set HostName "john-personal-mbp"
```
- Restart you mac.
- Set up internet connection (Wi-Fi or Ethernet).
- Configure user information and password:
  - Settings > Users & Groups
  - Settings > [Your Name] (Apple ID)
Double-check/set names in:
- Settings > General > About > Name (ComputerName).
- Settings > General > Sharing (LocalHostName).
- Make sure all file sharing are disabled.
- Restart you mac.

Set the default finder view

Open Finder.
Set the preferred view (List, Column, etc.)
Go to View > Show view options.
Check "Always open in [selected] view".
Click "Use as Defaults" (applies to all folders of the same kind).

Optional: Reset finder preferences:

defaults delete com.apple.finder
killall Finder

Update MacOS and App Store apps

Update macOS to the latest stable version (optional but recommended) with the following command:

⚠️ Avoid updating if the latest version is newly released and potentially unstable.
```
sudo softwareupdate --install --recommended --restart
```
Update all App Store apps manually, and delete unused apps if needed (optional but recommended).

Agree to license

sudo softwareupdate --agree-to-license --install-rosetta

MacOS system settings

System Settings
- User (Apple Account)
  - Check personal infos
  - Setup iCloud sync (disable most options)
- Wi-Fi
  - Ask to join hotspots > off
- General
  - Software Updates
    - Disable all automatic updates (except Security Responses)
  - AutoFill & Passwords
    - Autofill Passwords and Passkeys > off
    - Autofill from > Passwords > off
- Accessibility
  - Pointer Control > Trackpad options > Scroll speed > 6/7
  - Pointer Control > Mouse options > Scroll speed > 6/7
- Appearance
  - Auto
  - Show Scroll Bars > Always
- Apple Intelligence & Siri
  - Both > off
- Control Center
  - Battery > Show Percentage > on
  - Spotlight > Don't show in Menu Bar
- Desktop & Dock
  - Dock
    - Remove all applications from Dock
    - Adjust dock size (smaller)
    - Minimize windows using > Scale Effect
    - Double-click a window's title bar to > Do nothing
    - Minimize windows into application icon > on
    - Automatically hide an show the dock > on
    - Show suggested and recent apps in Dock -> off
  - Desktop & Stage Manager
    - Show Items > On Desktop > off
    - Show Items > On Stage Manager > off
    - Click wallpaper to reveal desktop > Only in stage manager
  - Windows
    - Drag windows to screen edges to tile > off
    - Drag windows to menu bar to fill screen > off
    - Hold ⌥ key while dragging windows to tile > off
  - Mission Control
    - Automatically rearrange Spaces based on most recent use > off
    - Drag windows to top of screento enter Mission Control > off
  - Hot Corners > Disable all
- Displays
  - True Tone > off
- Spotlight
  - Help Apple Improve Search > off
- Notifications
  - Disable most app notifications
- Sound
  - Play sound on startup > off
- Lock Screen
  - Screen saver > 5 minutes
  - Display off on battery > 5 minutes
  - Display off on power > 10 minutes
  - Require password after > 15 minutes
  - Show large clock > On Screen saver and Lock screen
- Privacy & Security
  - Location Services
    - Siri > off
    - System Services
      - Suggestions & Search > off
      - Mac Analytics > off
  - Apple Intelligence Report > off
  - FileVault > on
- Touch ID & Password
  - Set 3 fingers
- Game Center > Sign Out
- Wallet & Apple Pay
  - Setup if needed
- Keyboard
  - Key repeat rate > Maximum (fast)
  - Delay until repeat > Maximum (short)
  - Press 'globe' key to > Do nothing
  - Keyboard shortcuts
    - Mission Control > Mission Control > Turn off everything
    - Spotlight > Turn off everything
  - Text input > Add French - Numerical
  - Text input > Edit > All input sources
    - Correct spelling > off
    - Capitalize words > off
    - Show inline predictive text > off
    - Add period with double-space > off
    - Use smart quotes and dashes > off
    - For double quotes > "
    - For single quotes > '
- Trackpad
  - Point & Click
    - Tracking speed > 7/9
    - Click > Light
    - Force Click & haptic feedback > off
    - Look up & data detectors > off
    - Tap to Click > on
  - Scroll & Zoom
    - Smart zoom > off
    - Natural Scrolling > on
- Mouse
  - Scroll speed > 4/9
  - Natural Scrolling > on
  - Scrolling speed > 4/9
  - Advanced
    - Pointer acceleration > off
Finder > Settings
- General
  - Show these items on the desktop: disable all
  - New Finder windows show: [User]
- Tags
  - Disable all Tags
- Sidebar:
  - Activate Recents, Desktop, Documents, Downloads, [User]
  - Disable all iCloud
  - Activate all locations except [Computer]
  - Move Dev to Favorites in Sidebar
  - Disable all Tags
- Advanced
  - Show all filename extensions > on
  - Keep folders on top
    - In windows when sorting by name > on
    - On Desktop > on
  - When performing a search > Search Current Folder
Finder > View
- Show Preview

Install Command Line Tools

Install the Command Line Tools with the following command:

xcode-select --install

Initialize `chezmoi` and sync dotfiles

It will :

Sync dotfiles
Set some defaults settings
Install Homebrew and all packages from Brewfile
Install Xcode Command Line Tools

Initialize chezmoi with this command:

sh -c "$(curl -fsLS get.chezmoi.io)" -- init --apply $GITHUB_USERNAME

Setup SSH Key for Github

Github documentation on SSH Keys

Generate a new SSH Key

Generate a new SSH Key named “github_personal”:

mkdir -p ~/.ssh
cd ~/.ssh
ssh-keygen -t ed25519 -C "github_personal" -f "github_personal"

# When prompted, enter a strong passphrase for more security

Add the key in the ~/.ssh/config file to assign it to github.com host:

echo "\nHost github.com\nAddKeysToAgent yes\nUseKeychain yes\nIdentityFile ~/.ssh/github_personal" >> ~/.ssh/config

Add the SSH Key in the Apple Keychain

ssh-add --apple-use-keychain ~/.ssh/github_personal

Add the SSH Key to your Github account

Copy the public Key with the following command:
```
cat ~/.ssh/github_personal.pub | pbcopy
```
Go to the Add new SSH Key page on Github, and fill the SSH Key informations:
- Title = “Personal Macbook Pro” (or whatever you want)
- Key Type = ”Authentication Key”
- Key = [Paste the key] (copied just before with pbcopy)
Click on Add SSH Key, and if prompted, confirm access to your account on GitHub.

Verify the SSH Connexion

Now the SSH Key should be configured correctly.

Execute the following command to test SSH Connexion on Github:
```
ssh -T [email protected]
```

You may see a warning like this:

The authenticity of host 'github.com (IP ADDRESS)' can't be established.
ED25519 key fingerprint is SHA256:xxxxxxxxxxxx

Are you sure you want to continue connecting (yes/no)?

Verify that the fingerprint in the message you see matches GitHub's public key fingerprint. If it does, then type yes and press Enter.

Now you should see the following message:
```
Hi USERNAME! You've successfully authenticated,
but GitHub does not provide shell access.
```
- If the resulting message contains your username ⇒ Everything is ok !
- If you receive a "permission denied" message ⇒ See Error: Permission denied (publickey).

Setup GPG Key for Github (optional but recommended)

GPG Keys are used to sign Github commits, they increase security and guarantee that you are the author of the commits.

Github documentation on GPG Keys

Generate a new GPG Key

Install gnupg homebrew package to manage GPG Keys:
```
brew install gnupg
```

Generate a new GPG Key:

gpg --full-generate-key

# When prompted for key type, select RSA
# When prompted for key size, select 4096
# When prompted for expiration, select no expiration
# When prompted for user informations, enter your github Name and Email
# When prompted for passphrase, enter a strong passphrase for more security

List the keys:

gpg --list-secret-keys --keyid-format=long

From the list of GPG Keys, copy the long form of the GPG Key ID you'd like to use. In this example, the GPG Key ID is 3AA5C34371567BD2:

/Users/hubot/.gnupg/secring.gpg
------------------------------------
sec   4096R/3AA5C34371567BD2 2016-03-10 [expires: 2017-03-10]
uid                          Hubot <[email protected]>
ssb   4096R/4BB6D45482678BE3 2016-03-10

Add the GPG Key to your Github account

Copy the GPG Key with the following command (replace the key ID with your own, ID from the previous step):
```
gpg --armor --export 3AA5C34371567BD2 | pbcopy
```
Go to the Add new GPG Key page on Github, and fill the GPG Key informations:
- Title = “Personal Macbook Pro” (or whatever you want)
- Key = [Paste the key] (copied just before with pbcopy)
Click on Add GPG Key, and if prompted, confirm access to your account on GitHub.

Add GPG Key to your local git

If you have previously configured Git to use a different key format, unset this configuration so the default format of openpgp will be used:
```
git config --global --unset gpg.format
```

List the GPG keys:

gpg --list-secret-keys --keyid-format=long

From the list of GPG keys, copy the long form of the GPG key ID you'd like to use. In this example, the GPG key ID is 3AA5C34371567BD2:

/Users/hubot/.gnupg/secring.gpg
------------------------------------
sec   4096R/3AA5C34371567BD2 2016-03-10 [expires: 2017-03-10]
uid                          Hubot <[email protected]>
ssb   4096R/4BB6D45482678BE3 2016-03-10

To set your primary GPG signing key in Git, paste the text below, substituting in the GPG primary key ID you'd like to use. In this example, the GPG key ID is 3AA5C34371567BD2:
```
git config --global user.signingkey 3AA5C34371567BD2
```
To configure Git to sign all commits by default, enter the following command (optional but recommended):
```
git config --global commit.gpgsign true
```
run the following command in the zsh shell to add the GPG key to your .zshrc file:
```
echo -e '\nexport GPG_TTY=$(tty)' >> ~/.zshrc
```
Run the following command and restart your terminal:
```
source ~/.zshrc
```

Verify the GPG Key by signing a commit

Now the GPG Key should be correctly configured.

Execute the following command to create a signed commit:
```
git commit -S -m "YOUR_COMMIT_MESSAGE"
```
When prompted, provide the passphrase you set up when you generated your GPG key.
On github, navigate to the commits list of your repository. And you should see the “Verified” badge next to your commit :

App configurations

Standalone apps

Akko Cloud Driver (for Akko keyboard)

Chrome extensions

Bitwarden
Css Peeper
Dark Reader
Detailed SEO
GoFullPage
JSON Formatter
Localhost Open Graph Tester
(MetaMask)
(Rabby Wallet)
Raindrop.io
React Developer Tools
Tag Assistant
Todoist for Chrome
uBlock Origin / uBlock Origin Lite
Wappalyzer
Wave
What Font

Applications settings

Built-in apps
- Apple Mail
  - General
    - Unread count > All mailboxes
    - New message notification > All mailboxes
  - Accounts > Check and add accounts
  - Viewing
    - Show most recent messages at top > on
- Apple Contacts
  - General
    - Sort by > First Name
    - Address format > France
- Apple Calendar
  - Default calendar > Perso
  - Alerts (setup in all accounts)
    - Events > 15 minutes before
    - All day events > 1 day before
- Find my
  - Enable, setup and check devices
- iMessage
  - Sync iCloud for iMessages just for the sake of syncing, then disable iCloud again
  - Sync contacts on iCloud
  - iPhone: activate message forwarding to new Mac
- Notes
  - New notes start with: Body
  - Settings > Group notes by date > off
Other apps
- Logi Options + Mouse
  - Buttons
    - Wheel button > Middle button
    - Top button > Shift wheel mode
    - Thumb wheel > Horizontal scroll
    - Forward button > Forward
    - Back button > Back
    - Thumb button > Gestures > Window navigation
  - Point and Scroll
    - Pointer
      - Pointer speed > 65%
    - Scroll wheel
      - Scroll speed > 50%
      - Scroll direction > Standard
      - Smooth scrolling > Off
      - Smart Shift > On
    - Thumb wheel
      - Speed > 75%
      - Scroll direction > Inverted
- SwipeAeroSpace
  - Swipe treshold > 0.15
  - Number of fingers > 3
  - Wrap workspaces > off
  - Natural swipe > on
  - Skip empty workspaces > on
  - Launch at login > on
- Ice
  - General
    - Launch at login > on
    - Show Ice icon > on
    - Ice icon > Chevron
    - Use Ice Bar > off
    - Show on click, hover, scroll > off
    - Automatically rehide > on
    - Strategy > Smart
  - Menu Bar Appearance
    - Tint > Solid - Magnesium
    - Shadow > off
    - Border > off
    - Menu Bar Shape > Split - Rounded - Rounded
    - Use inset shape with notch > on
  - Advanced
    - Hide apps menus when showing menu bar items > on
    - Show section dividers > off
    - Show all when Cmd + Dragging items > on
    - Enable always-hidden section > off
  - Updates
    - Automatically check for updates > on
    - Automatically download updates > off
- Mos
  - Check settings imported from dotfiles
- Raycast
  - Import settings from dotfiles in Raycast settings
- Bitwarden
  - Connect to Bitwarden account
  - Vault timeout > On system lock
  - Vault timeout action > Lock
  - Unlock with pin > on
  - Unlock with Touch ID > on
  - Ask for touch ID on app start > on
  - Allow browser integration > on
  - Require verification for browser integration > on
- Brave Browser / Chrome
  - Add to sync chain
- Cursor
  - Connect to cursor account
- iTerm
  - General > Settings > Load settings from a custom folder > ~/.config/iterm2
- ChatGPT
  - Connect to ChatGPT account
  - Show in menu bar > Never
  - Enable Work with Apps > off
  - Speech > Voice > Spruce
  - Speech > Main Language > French
- Notion
  - Connect to Notion account
  - Preferences
    - Show Notion in menu bar > off
    - Cookie settings > Disable Analytics and Marketing
- Todoist
  - Connect to Todoist account
  - Général
    - Langue > Français
  - Avancé
    - Afficher Todoist dans la barre de menu > off
  - Thème
    - Synchroniser le thème > on
    - Mode sombre automatique > on
- Raindrop
  - Connect to Raindrop account
- Google Drive
  - Connect to Google Drive account
- Spotify
  - Connect to Spotify account
  - Streaming quality > Very High
  - Download quality > Very High
  - Auto adjust quality > on
  - Display short looping visuals > off
  - Open Spotify automatically > off
- Screaming Frog SEO
  - Set database folder
- Android Studio
- XCodes
- Bruno
- Table Plus
- CameraController
- ImageOptim
- TestFlight
- VLC
- IPTVNator
- Transmission

Name		Name	Last commit message	Last commit date
Latest commit History 109 Commits
home		home
.chezmoiroot		.chezmoiroot
.gitignore		.gitignore
README.md		README.md

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Repository files navigation

Dotfiles

Installation guide

Introduction

Setting up MacOS names

Set the default finder view

Update MacOS and App Store apps

Agree to license

MacOS system settings

Install Command Line Tools

Initialize `chezmoi` and sync dotfiles

Setup SSH Key for Github

Generate a new SSH Key

Add the SSH Key to your Github account

Verify the SSH Connexion

Setup GPG Key for Github (optional but recommended)

Generate a new GPG Key

Add the GPG Key to your Github account

Add GPG Key to your local git

Verify the GPG Key by signing a commit

App configurations

Standalone apps

Chrome extensions

Applications settings

About

Uh oh!

Releases

Packages

Languages

bastienlimbour/dotfiles

Folders and files

Latest commit

History

Repository files navigation

Dotfiles

Installation guide

Introduction

Setting up MacOS names

Set the default finder view

Update MacOS and App Store apps

Agree to license

MacOS system settings

Install Command Line Tools

Initialize chezmoi and sync dotfiles

Setup SSH Key for Github

Generate a new SSH Key

Add the SSH Key to your Github account

Verify the SSH Connexion

Setup GPG Key for Github (optional but recommended)

Generate a new GPG Key

Add the GPG Key to your Github account

Add GPG Key to your local git

Verify the GPG Key by signing a commit

App configurations

Standalone apps

Chrome extensions

Applications settings

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Languages

Initialize `chezmoi` and sync dotfiles

Packages