{"id":19044430,"url":"https://github.com/tilt-dev/workshop","last_synced_at":"2025-10-13T08:15:37.844Z","repository":{"id":47702620,"uuid":"390061666","full_name":"tilt-dev/workshop","owner":"tilt-dev","description":"Interactive onboarding workshop","archived":false,"fork":false,"pushed_at":"2021-08-17T15:28:13.000Z","size":30,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-01-02T08:15:01.007Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tilt-dev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-07-27T16:56:36.000Z","updated_at":"2021-08-17T15:28:14.000Z","dependencies_parsed_at":"2022-09-23T17:13:05.886Z","dependency_job_id":null,"html_url":"https://github.com/tilt-dev/workshop","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tilt-dev%2Fworkshop","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tilt-dev%2Fworkshop/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tilt-dev%2Fworkshop/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tilt-dev%2Fworkshop/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tilt-dev","download_url":"https://codeload.github.com/tilt-dev/workshop/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240100558,"owners_count":19747689,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-08T22:46:19.034Z","updated_at":"2025-10-13T08:15:32.808Z","avatar_url":"https://github.com/tilt-dev.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Tilt Onboarding Workshop\nThis repo contains resources to build your very own Tilt onboarding workshop:\n * Slide templates to introduce Tilt\n * Customizable, interactive tutorial generator\n * ~~Free ice cream~~\n \n## Slide Template\nYou can [preview][slide-deck-preview] or [make a copy][slide-deck-copy]  of our slide template, which helps you walk new users through Tilt install and set up.\n\n## Tutorial Generator\nIntroduce your team to Tilt via a brief tutorial tailored to your project that runs _within_ Tilt.\nIt's meta and awesome.\n\n### As the tutorial author...\n\nThis repo includes a tool to assemble your own interactive Tilt tutorial.\n\nYou will need Python 3.6+ (included by default on recent macOS versions and most Linux distributions).\n\nTo try out the sample tutorial, you can run `tilt up` on this repo.\nIt will automatically be rebuilt whenever you change an input file in `sample-tutorial/`.\n\nYou can also work in your actual project repo, which makes testing out custom logic much easier.\nAdd the following to your `Tiltfile`:\n```python\nif os.getenv('WORKSHOP_DEV'):\n    git_ext = load_dynamic('ext://git_resource')\n    git_ext['git_checkout']('https://github.com/tilt-dev/workshop.git#main')\n    local('if [ ! -d ./tilt-tutorial ]; then cp -R ./.git-sources/workshop/sample-tutorial ./tilt-tutorial; fi')\n    local_resource('tutorial-generator',\n                   cmd='python3 ./.git-sources/workshop/tutorial-generator/gen.py ./tilt-tutorial',\n                   deps=['./tilt-tutorial', './.git-sources/workshop'])\n    os.putenv('WORKSHOP', '1')\n    watch_file('workshop.tiltfile')\n    if os.path.exists('workshop.tiltfile'):\n       load_dynamic('workshop.tiltfile')\n```\nLaunch Tilt with `WORKSHOP_DEV=1 tilt up` and it will create a `tilt-tutorial` directory with a copy of the sample tutorial input.\nAdditionally, new `workshop` and `tutorial-generator` resources will appear.\nThe workshop will automatically be rebuilt whenever you change an input file in `tilt-tutorial/`.\n\n:information_source: Add `.git-sources` (and optionally `tilt-tutorial` for the input files) to your `.gitignore`.\n\nOnce you're happy with it, commit `workshop.tiltfile` to your project's repo and add the following to your main `Tiltfile`:\n```python\nload_dynamic('workshop.tiltfile')\n```\n\nThen run `WORKSHOP=1 tilt up` on your project and try it out!\n\n### As a workshop attendee...\nTo run the workshop, you'll need Bash: it should work out of the box on macOS/Linux.\nWindows users can use WSL2 (Windows Subsystem for Linux) or a VM.\n\nThe workshop is inactive by default so that it does not interfere with day-to-day Tilt usage.\nAttendees should launch Tilt with `WORKSHOP=1 tilt up` to activate.\n\n## Duplicating this Repo\nIf you choose to create a copy of this repo so that you can version your custom tutorial, please take care in how you copy it.\n\n:warning: If you **fork** this repo, it will be public!\n\nTo manually duplicate this repo (either to a private GitHub repo or to an internal repo):\n1. Create a new Git repository\n2. Duplicate this project to your new Git repository (adapted from [GitHub docs][duplicate-repo]):\n    ```sh\n    # create a temporary clone\n    git clone --bare https://github.com/tilt-dev/workshop /tmp/tilt-workshop\n    # navigate to the temporary clone\n    cd /tmp/tilt-workshop\n    # mirror push to _your_ repository\n    git push --mirror YOUR_NEW_GIT_REPO_URL\n\n    # remove the temporary clone\n    cd ~\n    rm -rf /tmp/tilt-workshop\n    ```\n3. Clone your new repo and open in your favorite editor!\n\n\n[duplicate-repo]: https://docs.github.com/en/github/creating-cloning-and-archiving-repositories/creating-a-repository-on-github/duplicating-a-repository\n[slide-deck-preview]: https://docs.google.com/presentation/d/1kJKilOWis_0tlgIDwA7oHVYhxx3Ebqm32glKv10O7zM/edit\n[slide-deck-copy]: https://docs.google.com/presentation/d/1kJKilOWis_0tlgIDwA7oHVYhxx3Ebqm32glKv10O7zM/copy\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftilt-dev%2Fworkshop","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftilt-dev%2Fworkshop","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftilt-dev%2Fworkshop/lists"}