init + dc-init

Author: xaoscience

.devcontainer/README.md

@@ -0,0 +1,75 @@
+# Container Configuration
+
+## Metadata
+- **Category**: `art`
+- **Type**: `Pre-built image`
+- **Container Name**: `.`
+
+## Generated Instructions
+
+1. Download the latest dev-control release tag (latest):
+
+   `gh release download latest --repo XAOSTECH/dev-control`
+
+   Or download directly (no gh required):
+
+   https://github.com/XAOSTECH/dev-control/releases/tag/latest
+
+2. Load aliases (includes dc-contain):
+
+   `source ./scripts/alias-loading.sh`
+
+3. Build a base image (example):
+
+   `dc-contain --base --art --defaults`
+   `dc-contain --base --art`  # interactive config
+
+4. Run the script directly (same example):
+
+   `./scripts/containerise.sh --base --art --defaults`
+
+5. Generate an image-based devcontainer (example):
+
+   `dc-contain --img --art`
+
+## About
+
+This devcontainer uses a pre-built dev-control category image.
+**Base Image:** `devcontrol/art:latest`
+
+This folder is generated from a base image. The usual flow is:
+
+- Build the base image in a parent folder
+- Then generate this image-based devcontainer using `--img`
+
+**Features:** 2D/3D art tools: Krita, GIMP, Inkscape, Blender, ImageMagick
+
+**Build source:** https://github.com/xaostech/dev-control/tree/main/.devcontainer/art
+
+## Files
+
+- **devcontainer.json** - Your personal VS Code devcontainer configuration (gitignored)
+- **Dockerfile** - Your personal container image definition (gitignored)
+- **.dockerignore** - Files to exclude from build context
+- **README.md** - This file
+- **devcontainer_example.json** - Tracked reference with placeholder values
+- **Dockerfile_example** - Tracked reference Dockerfile
+- **devcontainer_minimal.json** - Tracked minimal configuration
+- **Dockerfile_minimal** - Tracked minimal Dockerfile
+
+## Usage
+
+1. Open this project in VS Code
+2. Press `F1` and run: `Dev Containers: Reopen in Container`
+3. The container will build and you'll work inside it
+
+## Customisation
+
+Edit `devcontainer.json` or `Dockerfile` to customise:
+- Installed tools and libraries
+- Environment variables
+- VSCode extensions
+- Mount points and volumes
+
+For more information, see the Dev Containers docs:
+https://code.visualstudio.com/docs/devcontainers/containers

.devcontainer/devcontainer_example.json

@@ -0,0 +1,39 @@
+{
+  "name": "DES",
+  "image": "devcontrol/art:latest",
+  "remoteUser": "art",
+  "workspaceMount": "source=${localWorkspaceFolder},target=/workspaces/DES,type=bind,consistency=cached",
+  "workspaceFolder": "/workspaces/DES",
+  "runArgs": [
+    "--shm-size=1g","--device=/dev/dri","--device=/dev/nvidia0","--device=/dev/nvidiactl","--device=/dev/nvidia-modeset","--device=/dev/nvidia-uvm","--device=/dev/nvidia-uvm-tools"
+  ],
+  "mounts": [
+    "source=/run/user/1000/podman/podman.sock,target=/var/run/docker.sock,type=bind","source=${localEnv:HOME}/.config/gh,target=/home/art/.config/gh,type=bind,consistency=cached","source=${localEnv:XDG_RUNTIME_DIR}/${localEnv:WAYLAND_DISPLAY},target=/tmp/wayland-0,type=bind,readonly","source=/run/user/1000/wayland-0.lock,target=/tmp/wayland-0.lock,type=bind","source=/tmp/.X11-unix,target=/tmp/.X11-unix,type=bind","source=/usr/lib/x86_64-linux-gnu/libcuda.so.1,target=/usr/lib/x86_64-linux-gnu/libcuda.so.1,type=bind,readonly","source=/usr/lib/x86_64-linux-gnu/libnvcuvid.so.1,target=/usr/lib/x86_64-linux-gnu/libnvcuvid.so.1,type=bind,readonly"
+  ],
+  "containerEnv": {
+    "GPG_KEY_ID": "YOUR_GPG_KEY_ID",
+    "GITHUB_USER": "YOUR_GITHUB_USER",
+    "DOCKER_HOST": "unix:///var/run/docker.sock",
+    "DISPLAY": "${localEnv:DISPLAY}",
+    "TZ": "Europe/Brussels",
+    "NVIDIA_VISIBLE_DEVICES": "all",
+    "NVIDIA_DRIVER_CAPABILITIES": "compute,video,utility",
+    "__NV_PRIME_RENDER_OFFLOAD": "1",
+    "__GLX_VENDOR_LIBRARY_NAME": "nvidia",
+    "WAYLAND_DISPLAY": "wayland-0",
+    "XDG_RUNTIME_DIR": "/tmp"
+  },
+  "postCreateCommand": "sudo chown -R 1000:1000 . 2>/dev/null || true && sudo chmod 755 /home/art 2>/dev/null || true && sudo chown -R 1000:1000 /home/art/.vscode-server 2>/dev/null || true && sudo mkdir -p /home/art/.gnupg /home/art/.ssh /home/art/.cache /home/art/.config && sudo chown 1000:1000 /home/art/.gnupg /home/art/.ssh /home/art/.cache /home/art/.config && sudo chmod 700 /home/art/.gnupg /home/art/.ssh && sudo chmod 755 /home/art/.cache /home/art/.config && sudo mkdir -p /run/user/1000/gnupg && sudo chown -R 1000:1000 /run/user/1000 2>/dev/null || true && ln -sf /tmp/wayland-0 /run/user/1000/wayland-0 2>/dev/null || true && git config --global --add safe.directory '*' && git config --global init.defaultBranch main && git config --global user.email YOUR_GITHUB_EMAIL && git config --global user.name YOUR_GITHUB_USER && git config --global commit.gpgsign true && git config --global user.signingkey YOUR_GPG_KEY_ID && git config --global gpg.program gpg && bash -c 'bash /opt/dev-control/scripts/alias-loading.sh <<< A'",
+  "customizations": {
+    "vscode": {
+      "settings": {
+        "terminal.integrated.cwd": "/workspaces/DES",
+        "git.enableSmartCommit": true,
+        "git.autofetch": true
+      },
+      "extensions": [
+        "github.copilot","github.copilot-chat"
+      ]
+    }
+  }
+}

.devcontainer/devcontainer_minimal.json

@@ -0,0 +1,39 @@
+{
+  "name": "DES",
+  "image": "devcontrol/art:latest",
+  "remoteUser": "art",
+  "workspaceMount": "source=${localWorkspaceFolder},target=/workspaces/DES,type=bind,consistency=cached",
+  "workspaceFolder": "/workspaces/DES",
+  "runArgs": [
+    "--shm-size=1g","--device=/dev/dri","--device=/dev/nvidia0","--device=/dev/nvidiactl","--device=/dev/nvidia-modeset","--device=/dev/nvidia-uvm","--device=/dev/nvidia-uvm-tools"
+  ],
+  "mounts": [
+    "source=/run/user/1000/podman/podman.sock,target=/var/run/docker.sock,type=bind","source=${localEnv:XDG_RUNTIME_DIR}/${localEnv:WAYLAND_DISPLAY},target=/tmp/wayland-0,type=bind,readonly","source=/run/user/1000/wayland-0.lock,target=/tmp/wayland-0.lock,type=bind","source=/tmp/.X11-unix,target=/tmp/.X11-unix,type=bind","source=/usr/lib/x86_64-linux-gnu/libcuda.so.1,target=/usr/lib/x86_64-linux-gnu/libcuda.so.1,type=bind,readonly","source=/usr/lib/x86_64-linux-gnu/libnvcuvid.so.1,target=/usr/lib/x86_64-linux-gnu/libnvcuvid.so.1,type=bind,readonly"
+  ],
+  "containerEnv": {
+    "GPG_KEY_ID": "",
+    "GITHUB_USER": "",
+    "DOCKER_HOST": "unix:///var/run/docker.sock",
+    "DISPLAY": "${localEnv:DISPLAY}",
+    "TZ": "Europe/Brussels",
+    "NVIDIA_VISIBLE_DEVICES": "all",
+    "NVIDIA_DRIVER_CAPABILITIES": "compute,video,utility",
+    "__NV_PRIME_RENDER_OFFLOAD": "1",
+    "__GLX_VENDOR_LIBRARY_NAME": "nvidia",
+    "WAYLAND_DISPLAY": "wayland-0",
+    "XDG_RUNTIME_DIR": "/tmp"
+  },
+  "postCreateCommand": "sudo chown -R 1000:1000 . 2>/dev/null || true && sudo chmod 755 /home/art 2>/dev/null || true && sudo chown -R 1000:1000 /home/art/.vscode-server 2>/dev/null || true && sudo mkdir -p /home/art/.gnupg /home/art/.ssh /home/art/.cache /home/art/.config && sudo chown 1000:1000 /home/art/.gnupg /home/art/.ssh /home/art/.cache /home/art/.config && sudo chmod 700 /home/art/.gnupg /home/art/.ssh && sudo chmod 755 /home/art/.cache /home/art/.config && sudo mkdir -p /run/user/1000/gnupg && sudo chown -R 1000:1000 /run/user/1000 2>/dev/null || true && ln -sf /tmp/wayland-0 /run/user/1000/wayland-0 2>/dev/null || true && git config --global --add safe.directory '*' && git config --global init.defaultBranch main && bash -c 'bash /opt/dev-control/scripts/alias-loading.sh <<< A'",
+  "customizations": {
+    "vscode": {
+      "settings": {
+        "terminal.integrated.cwd": "/workspaces/DES",
+        "git.enableSmartCommit": true,
+        "git.autofetch": true
+      },
+      "extensions": [
+        "github.copilot","github.copilot-chat"
+      ]
+    }
+  }
+}

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,43 @@
+---
+name: Bug Report
+about: Report a bug to help us improve
+title: '[BUG] '
+labels: bug
+assignees: ''
+---
+
+## 🐛 Bug Description
+
+A clear and concise description of what the bug is.
+
+## 📋 Steps to Reproduce
+
+1. Go to '...'
+2. Run command '...'
+3. See error
+
+## ✅ Expected Behaviour
+
+A clear and concise description of what you expected to happen.
+
+## ❌ Actual Behaviour
+
+What actually happened instead.
+
+## 🖥️ Environment
+
+- **OS**: [e.g., Ubuntu 22.04, macOS 14.0]
+- **Shell**: [e.g., bash 5.1, zsh 5.9]
+- **Version**: [e.g., v1.0.0, commit abc123]
+
+## 📸 Screenshots / Logs
+
+If applicable, add screenshots or terminal output to help explain your problem.
+
+```
+Paste relevant logs here
+```
+
+## 📝 Additional Context
+
+Add any other context about the problem here.

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: true
+contact_links:
+  - name: 💬 Discussions
+    url: https://github.com/XAOSTECH/design-tools/discussions
+    about: Ask questions and discuss ideas
+  - name: 📖 Documentation
+    url: https://github.com/XAOSTECH/design-tools#readme
+    about: Read the documentation

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,33 @@
+---
+name: Feature Request
+about: Suggest an idea for this project
+title: '[FEATURE] '
+labels: enhancement
+assignees: ''
+---
+
+## 🚀 Feature Description
+
+A clear and concise description of the feature you'd like.
+
+## 💡 Problem / Motivation
+
+What problem does this solve? Why is this feature needed?
+
+## 📋 Proposed Solution
+
+Describe the solution you'd like to see implemented.
+
+## 🔄 Alternatives Considered
+
+A clear and concise description of any alternative solutions or features you've considered.
+
+## 📝 Additional Context
+
+Add any other context, mockups, or examples about the feature request here.
+
+## ✅ Acceptance Criteria
+
+- [ ] Criteria 1
+- [ ] Criteria 2
+- [ ] Criteria 3

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,41 @@
+## 📋 Description
+
+Brief description of the changes in this PR.
+
+## 🔗 Related Issue
+
+Fixes #(issue number)
+
+## 🔄 Type of Change
+
+- [ ] 🐛 Bug fix (non-breaking change which fixes an issue)
+- [ ] ✨ New feature (non-breaking change which adds functionality)
+- [ ] 💥 Breaking change (fix or feature that would cause existing functionality to not work as expected)
+- [ ] 📚 Documentation update
+- [ ] 🔧 Refactoring (no functional changes)
+- [ ] 🧪 Tests (adding or updating tests)
+
+## ✅ Checklist
+
+- [ ] My code follows the project's style guidelines
+- [ ] I have performed a self-review of my code
+- [ ] I have commented my code, particularly in hard-to-understand areas
+- [ ] I have made corresponding changes to the documentation
+- [ ] My changes generate no new warnings
+- [ ] I have tested my changes locally
+
+## 🧪 How Has This Been Tested?
+
+Describe the tests you ran to verify your changes.
+
+```bash
+# Example test commands
+```
+
+## 📸 Screenshots (if applicable)
+
+Add screenshots to help explain your changes.
+
+## 📝 Additional Notes
+
+Any additional information that reviewers should know.