https://github.com/dockersamples/labspace-about-labspaces
https://github.com/dockersamples/labspace-about-labspaces
Last synced: 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/dockersamples/labspace-about-labspaces
- Owner: dockersamples
- License: apache-2.0
- Created: 2026-03-26T14:16:51.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-03-26T14:17:09.000Z (3 months ago)
- Last Synced: 2026-03-27T05:43:07.297Z (3 months ago)
- Size: 9.77 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Labspace starter
This repository is intended to serve as a template to help bootstrap a new Labspace.
## ✨ Authoring with Claude Code
This repo includes a Claude Code slash command that can scaffold your entire labspace automatically — all section markdown files, `labspace.yaml`, `compose.override.yaml`, and starter project files.
**Prerequisites:** [Claude Code](https://docs.anthropic.com/en/docs/claude-code) installed
1. Clone your newly created repo to your local machine
2. Open the repo in Claude Code
3. Run:
```
/labspace-author Teach Docker networking using bridge and overlay networks
```
4. Claude will ask a few questions (audience, tech stack, GitHub repo URL) and then generate all the files
> You can also run `/labspace-author` with no arguments and Claude will guide you through it interactively.
## Instructions
1. Create a new repository using this repo as the template ([docs here](https://docs.github.com/en/repositories/creating-and-managing-repositories/creating-a-repository-from-a-template)).
> **NOTE:** After creating the repo, a GHA workflow will run to do some additional bootstrapping. The bootstrapping workflow file will be removed during bootstrapping.
2. Clone your newly created repo to your local machine
3. Start the local development mode:
```bash
# On Mac/Linux
CONTENT_PATH=$PWD docker compose up --watch
# On Windows with PowerShell
$Env:CONTENT_PATH = (Get-Location).Path; docker compose up --watch
```
4. Update the `labspace/labspace.yaml` with your Labspace's title and description
5. Write your Labspace! Being in dev mode, your changes should be visible in the interface without a restart. Feel free to edit either on your host machine or in the Labspace itself!
Add any supporting application files or resources directly into the Labspace. This repo will be cloned into the Labspace at startup.
Be sure to check out the [docs](https://github.com/dockersamples/labspace-infra/tree/main/docs) for additional information and guidelines.
## Setting up the deployment pipeline
The template repo contains a workflow file to make it easy to publish your Labspace.
1. Add GitHub Action Secrets in your new repo for the following:
- `DOCKERHUB_USERNAME` - the username to authenticate to Docker Hub with
- `DOCKERHUB_TOKEN` - a personal or organization access token to use for authentication
2. In the `.github/workflows/publish-labspace.yaml.temp` file, update the `DOCKERHUB_REPO` with the name of the Docker Hub repo you want to publish to.
3. Rename the workflow file to remove the `.temp` extension.
```bash
mv .github/workflows/publish-labspace.yaml.temp .github/workflows/publish-labspace.yaml
```