uysio/huis

huis sets up your home directory so you can start being productive.

What is huis?

huis sets up your home directory so you can start being productive, and goes beyond dotfiles. huis is the Dutch word for home.

It'll aspire to be a multi-platform boxen.

Get started

git clone https://github.com/uysio/huis ~/.huis
cd ~/.huis
./huis.sh

How does it work?

huis will ask you which Github usernames' repos to look at, and it will find anything called huis-*, and clone it.

This way, you can choose which huis modules to fork, or develop yourself, and only those in the repos you specified will be used.

Special modules

huis-first, if it exists - it will be run first. huis-last, if it exists - it will be run last.

What goes inside a huis-* module?

At least one thing: a huis.sh file. The rest is up to you.

Also, huis modules are allowed to cross-reference one another. E.g. see this example.

Warning

I'm developing this as you read this. Don't use it - it isn't ready for public consumption.

I'd like to see all the side-effects

The easiest way (that comes to mind) to show the side-effects of the script is to run the script in a Docker container, for which I already provide a convenient Dockerfile.

docker build -f Dockerfile.arch -t $(whoami)/huis-arch .
docker run --rm -it -v $(pwd):/opt/huis $(whoami)/huis-arch
# inside the container:
cp /opt/huis/huis.sh .
./huis.sh

Test your new setup by refreshing the shell:

exec zsh
# or...
exec bash

From the host again:

docker diff <CONTAINER_ID> | egrep -v "\.git"