https://github.com/kulapoo/dotfiles
PopOs dotfiles
https://github.com/kulapoo/dotfiles
Last synced: about 2 months ago
JSON representation
PopOs dotfiles
- Host: GitHub
- URL: https://github.com/kulapoo/dotfiles
- Owner: kulapoo
- Created: 2024-11-23T11:48:47.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-11-30T10:59:36.000Z (over 1 year ago)
- Last Synced: 2025-01-27T22:46:09.386Z (over 1 year ago)
- Language: Shell
- Size: 50.8 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# README
## Overview
This dotfiles repository provides a comprehensive, idempotent installation system for setting up a development environment on Linux/Unix systems. It includes automated installation of development tools, programming languages, and applications.
## Prerequisites
- Ubuntu/Debian-based Linux distribution
- `curl` or `wget` installed
- `sudo` access for system-wide installations
## Installation
Run the main installation script with sudo:
```sh
sudo ./install.sh
```
This will:
1. Install Homebrew package manager automatically
2. Set up essential system packages
3. Configure Bash environment with Bash-it
4. Install programming languages (Python via uv, Node.js via nvm, Rust, PHP)
5. Set up development tools (Docker, Git, etc.)
6. Install desktop applications
## Features
### 🔄 Idempotent Installation
- Scripts can be run multiple times safely
- Checks for existing installations before proceeding
- No duplicate configurations or PATH entries
### 🐍 Modern Python Management
- Uses `uv` for Python version management (similar to nvm for Node.js)
- Pre-configured helper functions for virtual environments
- Essential Python tools pre-installed
### 📦 Package Managers
- Homebrew for command-line tools
- Flatpak for desktop applications
- Snap for additional packages
- All package managers installed automatically
### 🛠️ Development Tools
- Docker and Docker Compose
- Git with global configuration
- VS Code, Sublime Text, and other editors
- Guake drop-down terminal
## Verification
Check installation status:
```sh
./verify-installation.sh
```
Test idempotency:
```sh
./test-idempotency.sh
```
## Todo
- [ ] Add options to install specific packages.
- [ ] Add options to install specific applications.
- [ ] Add options to install specific fonts.
- [ ] Add options to install specific themes.
- [ ] Add options to install extra tooling.
- [ ] Add options to install specific configurations.
## License
This project is licensed under the MIT License.