Watts-Lab · JamesPHoughton · Nov 12, 2025
diff --git a/projects/example/demo_annotated/README.md → demo/annotated_demo/README.md b/projects/example/demo_annotated/README.md → demo/annotated_demo/README.md
diff --git a/...ample/demo_annotated/demo.treatments.yaml → ...tated_demo/annotated_demo.treatments.yaml b/...ample/demo_annotated/demo.treatments.yaml → ...tated_demo/annotated_demo.treatments.yaml
@@ -16,7 +16,7 @@ templates:
     templateContent: # here we implement a prompt that we will reuse below
       type: prompt
       name: ${topicName}_presurvey # templates can take fields that are substituted in the templateContent
-      file: projects/example/demo_annotated/topics/${topicName}_survey.md # fields use the syntax ${fieldName}
+      file: demo/annotated_demo/topics/${topicName}_survey.md # fields use the syntax ${fieldName}
 
   - templateName: crossPartisanDiscussion
     contentType: treatment # it is quite common for a template to include the whole treatment structure, so that small changes can be made between conditions
@@ -44,9 +44,9 @@ templates:
           duration: 45 # each stage has a specified duration in seconds
           elements: # the elements displayed during each stage are listed from top to bottom.
             - type: prompt # one type of element is a prompt, which displays text from a markdown file, and sometimes response options
-              file: projects/example/demo_annotated/game/describeConditionalAssignment.md # files are relative to the root path of the repository (for now), and can be organized however you like. In practice, it is helpful to organize by where the file is first used, e.g. intro, game, exit, and then separate folders for any stimuli that are used in multiple sections.
+              file: demo/annotated_demo/game/describeConditionalAssignment.md # files are relative to the root path of the repository (for now), and can be organized however you like. In practice, it is helpful to organize by where the file is first used, e.g. intro, game, exit, and then separate folders for any stimuli that are used in multiple sections.
             - type: prompt
-              file: projects/example/demo_annotated/game/describeVideos.md
+              file: demo/annotated_demo/game/describeVideos.md
             - type: timer # a timer is a progress bar counting down. It can start, end, and "warn" at the times you specify
               endTime: 10
             - type: submitButton # a submit button allows participants to proceed when they are (all) ready, rather than waiting for the timer
@@ -57,12 +57,12 @@ templates:
           duration: 45
           elements:
             - type: prompt
-              file: projects/example/demo_annotated/game/describeTiming.md
+              file: demo/annotated_demo/game/describeTiming.md
             - type: prompt
-              file: projects/example/demo_annotated/game/pre_discussion_instructions_democrat.md
+              file: demo/annotated_demo/game/pre_discussion_instructions_democrat.md
               showToPositions: [0] # elements can be shown to all participants (default), or only those in listed positions
             - type: prompt
-              file: projects/example/demo_annotated/game/pre_discussion_instructions_republican.md
+              file: demo/annotated_demo/game/pre_discussion_instructions_republican.md
               showToPositions: [1]
             - type: submitButton
               buttonText: Begin Discussion
@@ -76,13 +76,13 @@ templates:
             showTitle: true
           elements:
             - type: prompt
-              file: projects/example/demo_annotated/game/describeDiscussion.md
+              file: demo/annotated_demo/game/describeDiscussion.md
             - type: prompt
-              file: projects/example/demo_annotated/game/discussion_instructions.md
+              file: demo/annotated_demo/game/discussion_instructions.md
             - type: prompt
-              file: projects/example/demo_annotated/topics/${topicName}_discussion.md
+              file: demo/annotated_demo/topics/${topicName}_discussion.md
             - type: prompt
-              file: projects/example/demo_annotated/game/discussion_wrapup.md
+              file: demo/annotated_demo/game/discussion_wrapup.md
               displayTime: 15
             - type: submitButton
               name: endCall
@@ -93,9 +93,9 @@ templates:
         - name: ManipulationCheck # Exit sequence items are asynchronous, and so do not have durations
           elements:
             - type: prompt
-              file: projects/example/demo_annotated/exit/describeReferences.md
+              file: demo/annotated_demo/exit/describeReferences.md
             - type: prompt
-              file: projects/example/demo_annotated/exit/consider_partner.md
+              file: demo/annotated_demo/exit/consider_partner.md
 
             - type: display # you can display variables from earlier in the experiment using a display element
               reference: participantInfo.name # here we display the participant's partner's name
@@ -107,15 +107,15 @@ templates:
               showToPositions: [1]
 
             - type: prompt
-              file: projects/example/demo_annotated/exit/guess_partner_party.md
+              file: demo/annotated_demo/exit/guess_partner_party.md
               name: guessPartnerParty # when prompts ask for input, you should give them a name so the results can be recorded
             - type: prompt
-              file: projects/example/demo_annotated/exit/guess_partner_position.md
+              file: demo/annotated_demo/exit/guess_partner_position.md
             - type: prompt
               name: guessPartnerPosition
-              file: projects/example/demo_annotated/topics/${topicName}_survey.md
+              file: demo/annotated_demo/topics/${topicName}_survey.md
             - type: prompt
-              file: projects/example/demo_annotated/intro/all_mandatory.md # my convention is to organize files according to where they are first used. This also helps indicate when files are reused across sections of the study, and is helpful when you want to ask the same question in pre/post.
+              file: demo/annotated_demo/intro/all_mandatory.md # my convention is to organize files according to where they are first used. This also helps indicate when files are reused across sections of the study, and is helpful when you want to ask the same question in pre/post.
             - type: submitButton
               conditions:
                 - reference: prompt.guessPartnerParty
@@ -126,12 +126,12 @@ templates:
         - name: TraitRatingsPostTest # 8 questions
           elements:
             - type: prompt
-              file: projects/example/demo_annotated/exit/describeDisplayByPosition.md
+              file: demo/annotated_demo/exit/describeDisplayByPosition.md
             - type: prompt
-              file: projects/example/demo_annotated/exit/consider_democrats.md
+              file: demo/annotated_demo/exit/consider_democrats.md
               showToPositions: [1]
             - type: prompt
-              file: projects/example/demo_annotated/exit/consider_republicans.md
+              file: demo/annotated_demo/exit/consider_republicans.md
               showToPositions: [0]
             - type: survey # we have a number of "canned" surveys available, which are implemented here: https://github.com/Watts-Lab/surveys
               surveyName: TraitRatings # You include one just by specifying its name (this is different from the name below which is assigned to the response data)
@@ -144,25 +144,25 @@ introSequences: # introSequences are asynchronous sections that take place prior
       - name: Sequence Description
         elements:
           - type: prompt
-            file: projects/example/demo_annotated/intro/describeAsyncSync.md
+            file: demo/annotated_demo/intro/describeAsyncSync.md
           - type: submitButton
             buttonText: Continue
 
       - name: PoliticalLeaningsSurvey
         elements:
           - type: prompt
-            file: projects/example/demo_annotated/intro/describeSurvey.md
+            file: demo/annotated_demo/intro/describeSurvey.md
           - type: survey
             surveyName: PoliticalPartyUS
             name: partyAffiliation # don't forget to name elements that collect responses, we use this name in references when assigning participants to groups
 
       - name: TopicPreSurvey
         elements:
           - type: prompt
-            file: projects/example/demo_annotated/intro/describePrompts.md
+            file: demo/annotated_demo/intro/describePrompts.md
 
           - type: prompt
-            file: projects/example/demo_annotated/intro/presurvey_instructions.md
+            file: demo/annotated_demo/intro/presurvey_instructions.md
 
           - template: topicPrompt # references to templates can be used anywhere a full structure is allowed, and can be used multiple times
             broadcast: # values can be filled in using broadcasting, which creates multiple instances of the template with different field values
@@ -171,7 +171,7 @@ introSequences: # introSequences are asynchronous sections that take place prior
                 - topicName: slaveReparations
 
           - type: prompt
-            file: projects/example/demo_annotated/intro/all_mandatory.md
+            file: demo/annotated_demo/intro/all_mandatory.md
 
           - type: submitButton
             buttonText: Continue

diff --git a/...s/example/demo_annotated/demo.config.json → demo/annotated_demo/demo.config.json b/...s/example/demo_annotated/demo.config.json → demo/annotated_demo/demo.config.json
@@ -1,8 +1,8 @@
 {
   "batchName": "annotated_demo",
   "cdn": "prod",
-  "treatmentFile": "projects/example/demo_annotated/demo.treatments.yaml",
-  "customIdInstructions": "projects/example/demo_annotated/intro/describeAnnotatedDemo.md",
+  "treatmentFile": "demo/annotated_demo/demo.treatments.yaml",
+  "customIdInstructions": "demo/annotated_demo/intro/describeAnnotatedDemo.md",
   "platformConsent": "US",
   "consentAddendum": "none",
   "checkAudio": true,

diff --git a/...ts/example/demo_annotated/dev.config.json → demo/annotated_demo/dev.config.json b/...ts/example/demo_annotated/dev.config.json → demo/annotated_demo/dev.config.json
@@ -1,8 +1,8 @@
 {
   "batchName": "annotated_demo",
   "cdn": "local",
-  "treatmentFile": "projects/example/demo_annotated/demo.treatments.yaml",
-  "customIdInstructions": "projects/example/demo_annotated/intro/describeAnnotatedDemo.md",
+  "treatmentFile": "demo/annotated_demo/annotated_demo.treatments.yaml",
+  "customIdInstructions": "demo/annotated_demo/intro/describeAnnotatedDemo.md",
   "platformConsent": "US",
   "consentAddendum": "none",
   "checkAudio": true,

diff --git a/demo/annotated_demo/exit/consider_democrats.md b/demo/annotated_demo/exit/consider_democrats.md
@@ -0,0 +1,10 @@
+---
+name: demo/annotated_demo/exit/consider_democrats.md
+type: noResponse
+---
+
+![donkeyIcon](demo/annotated_demo/exit/donkey.jpg)
+
+# Please share your feelings about **Democrats**:
+
+---
diff --git a/...e/demo_annotated/exit/consider_partner.md → demo/annotated_demo/exit/consider_partner.md b/...e/demo_annotated/exit/consider_partner.md → demo/annotated_demo/exit/consider_partner.md
@@ -1,5 +1,5 @@
 ---
-name: projects/example/demo_annotated/exit/consider_partner.md
+name: demo/annotated_demo/exit/consider_partner.md
 type: noResponse
 ---
 

diff --git a/demo/annotated_demo/exit/consider_republicans.md b/demo/annotated_demo/exit/consider_republicans.md
@@ -0,0 +1,10 @@
+---
+name: demo/annotated_demo/exit/consider_republicans.md
+type: noResponse
+---
+
+![elephantIcon](demo/annotated_demo/exit/elephant.jpg)
+
+# Please share your feelings about **Republicans**:
+
+---
diff --git a/...notated/exit/describeDisplayByPosition.md → ...ed_demo/exit/describeDisplayByPosition.md b/...notated/exit/describeDisplayByPosition.md → ...ed_demo/exit/describeDisplayByPosition.md
@@ -1,5 +1,5 @@
 ---
-name: projects/example/demo_annotated/exit/describeDisplayByPosition.md
+name: demo/annotated_demo/exit/describeDisplayByPosition.md
 type: noResponse
 ---
 

diff --git a/...demo_annotated/exit/describeReferences.md → ...annotated_demo/exit/describeReferences.md b/...demo_annotated/exit/describeReferences.md → ...annotated_demo/exit/describeReferences.md
@@ -1,5 +1,5 @@
 ---
-name: projects/example/demo_annotated/exit/describeReferences.md
+name: demo/annotated_demo/exit/describeReferences.md
 type: noResponse
 ---
 

diff --git a/...ts/example/demo_annotated/exit/donkey.jpg → demo/annotated_demo/exit/donkey.jpg b/...ts/example/demo_annotated/exit/donkey.jpg → demo/annotated_demo/exit/donkey.jpg
diff --git a/.../example/demo_annotated/exit/elephant.jpg → demo/annotated_demo/exit/elephant.jpg b/.../example/demo_annotated/exit/elephant.jpg → demo/annotated_demo/exit/elephant.jpg
diff --git a/...emo_annotated/exit/guess_partner_party.md → ...nnotated_demo/exit/guess_partner_party.md b/...emo_annotated/exit/guess_partner_party.md → ...nnotated_demo/exit/guess_partner_party.md
@@ -1,5 +1,5 @@
 ---
-name: projects/example/demo_annotated/exit/guess_partner_party.md
+name: demo/annotated_demo/exit/guess_partner_party.md
 type: multipleChoice
 ---
 

diff --git a/..._annotated/exit/guess_partner_position.md → ...tated_demo/exit/guess_partner_position.md b/..._annotated/exit/guess_partner_position.md → ...tated_demo/exit/guess_partner_position.md
@@ -1,5 +1,5 @@
 ---
-name: projects/example/demo_annotated/exit/guess_partner_position.md
+name: demo/annotated_demo/exit/guess_partner_position.md
 type: noResponse
 ---
 

diff --git a/...ted/game/describeConditionalAssignment.md → ...emo/game/describeConditionalAssignment.md b/...ted/game/describeConditionalAssignment.md → ...emo/game/describeConditionalAssignment.md
@@ -1,5 +1,5 @@
 ---
-name: projects/example/demo_annotated/game/describeConditionalAssignment.md
+name: demo/annotated_demo/game/describeConditionalAssignment.md
 type: noResponse
 ---
 

diff --git a/...demo_annotated/game/describeDiscussion.md → ...annotated_demo/game/describeDiscussion.md b/...demo_annotated/game/describeDiscussion.md → ...annotated_demo/game/describeDiscussion.md
@@ -1,5 +1,5 @@
 ---
-name: projects/example/demo_annotated/game/describeDiscussion.md
+name: demo/annotated_demo/game/describeDiscussion.md
 type: noResponse
 ---
 

diff --git a/...ple/demo_annotated/game/describeTiming.md → demo/annotated_demo/game/describeTiming.md b/...ple/demo_annotated/game/describeTiming.md → demo/annotated_demo/game/describeTiming.md
@@ -1,5 +1,5 @@
 ---
-name: projects/example/demo_annotated/game/describeTiming.md
+name: demo/annotated_demo/game/describeTiming.md
 type: noResponse
 ---
 

diff --git a/...ple/demo_annotated/game/describeVideos.md → demo/annotated_demo/game/describeVideos.md b/...ple/demo_annotated/game/describeVideos.md → demo/annotated_demo/game/describeVideos.md
@@ -1,5 +1,5 @@
 ---
-name: projects/example/demo_annotated/game/describeVideos.md
+name: demo/annotated_demo/game/describeVideos.md
 type: noResponse
 ---
 

diff --git a/...annotated/game/discussion_instructions.md → ...ated_demo/game/discussion_instructions.md b/...annotated/game/discussion_instructions.md → ...ated_demo/game/discussion_instructions.md
@@ -1,5 +1,5 @@
 ---
-name: projects/example/demo_annotated/game/discussion_instructions.md
+name: demo/annotated_demo/game/discussion_instructions.md
 type: noResponse
 ---
 

diff --git a/.../demo_annotated/game/discussion_wrapup.md → .../annotated_demo/game/discussion_wrapup.md b/.../demo_annotated/game/discussion_wrapup.md → .../annotated_demo/game/discussion_wrapup.md
@@ -1,5 +1,5 @@
 ---
-name: projects/example/demo_annotated/game/discussion_wrapup.md
+name: demo/annotated_demo/game/discussion_wrapup.md
 type: noResponse
 ---
 

diff --git a/...e/pre_discussion_instructions_democrat.md → ...e/pre_discussion_instructions_democrat.md b/...e/pre_discussion_instructions_democrat.md → ...e/pre_discussion_instructions_democrat.md
@@ -1,5 +1,5 @@
 ---
-name: projects/example/demo_annotated/game/pre_discussion_instructions_democrat.md
+name: demo/annotated_demo/game/pre_discussion_instructions_democrat.md
 type: noResponse
 notes: To be shown to democrats paired with a republican
 ---

diff --git a/...pre_discussion_instructions_republican.md → ...pre_discussion_instructions_republican.md b/...pre_discussion_instructions_republican.md → ...pre_discussion_instructions_republican.md
@@ -1,5 +1,5 @@
 ---
-name: projects/example/demo_annotated/game/pre_discussion_instructions_republican.md
+name: demo/annotated_demo/game/pre_discussion_instructions_republican.md
 type: noResponse
 notes: To be shown to republicans paired with a democrat
 ---

diff --git a/...ts/example/demo_annotated/intro/README.md → demo/annotated_demo/intro/README.md b/...ts/example/demo_annotated/intro/README.md → demo/annotated_demo/intro/README.md
diff --git a/...ple/demo_annotated/intro/all_mandatory.md → demo/annotated_demo/intro/all_mandatory.md b/...ple/demo_annotated/intro/all_mandatory.md → demo/annotated_demo/intro/all_mandatory.md
@@ -1,5 +1,5 @@
 ---
-name: projects/example/demo_annotated/intro/all_mandatory.md
+name: demo/annotated_demo/intro/all_mandatory.md
 type: noResponse
 ---
 

diff --git a/..._annotated/intro/describeAnnotatedDemo.md → ...tated_demo/intro/describeAnnotatedDemo.md b/..._annotated/intro/describeAnnotatedDemo.md → ...tated_demo/intro/describeAnnotatedDemo.md
diff --git a/...demo_annotated/intro/describeAsyncSync.md → ...annotated_demo/intro/describeAsyncSync.md b/...demo_annotated/intro/describeAsyncSync.md → ...annotated_demo/intro/describeAsyncSync.md
@@ -1,5 +1,5 @@
 ---
-name: projects/example/demo_annotated/intro/describeAsyncSync.md
+name: demo/annotated_demo/intro/describeAsyncSync.md
 type: noResponse
 ---
 

diff --git a/...e/demo_annotated/intro/describePrompts.md → demo/annotated_demo/intro/describePrompts.md b/...e/demo_annotated/intro/describePrompts.md → demo/annotated_demo/intro/describePrompts.md
@@ -1,5 +1,5 @@
 ---
-name: projects/example/demo_annotated/intro/describePrompts.md
+name: demo/annotated_demo/intro/describePrompts.md
 type: noResponse
 ---
 

diff --git a/...le/demo_annotated/intro/describeSurvey.md → demo/annotated_demo/intro/describeSurvey.md b/...le/demo_annotated/intro/describeSurvey.md → demo/annotated_demo/intro/describeSurvey.md
@@ -1,5 +1,5 @@
 ---
-name: projects/example/demo_annotated/intro/describeSurvey.md
+name: demo/annotated_demo/intro/describeSurvey.md
 type: noResponse
 ---
 

diff --git a/...annotated/intro/presurvey_instructions.md → ...ated_demo/intro/presurvey_instructions.md b/...annotated/intro/presurvey_instructions.md → ...ated_demo/intro/presurvey_instructions.md
@@ -1,5 +1,5 @@
 ---
-name: projects/example/demo_annotated/intro/presurvey_instructions.md
+name: demo/annotated_demo/intro/presurvey_instructions.md
 type: noResponse
 ---
 

diff --git a/..._annotated/topics/israelAid_discussion.md → ...tated_demo/topics/israelAid_discussion.md b/..._annotated/topics/israelAid_discussion.md → ...tated_demo/topics/israelAid_discussion.md
@@ -1,5 +1,5 @@
 ---
-name: projects/example/demo_annotated/topics/israelAid_discussion.md
+name: demo/annotated_demo/topics/israelAid_discussion.md
 title: israelAid
 type: noResponse
 ---

diff --git a/...demo_annotated/topics/israelAid_survey.md → ...annotated_demo/topics/israelAid_survey.md b/...demo_annotated/topics/israelAid_survey.md → ...annotated_demo/topics/israelAid_survey.md
@@ -1,5 +1,5 @@
 ---
-name: projects/example/demo_annotated/topics/israelAid_survey.md
+name: demo/annotated_demo/topics/israelAid_survey.md
 title: israelAid
 type: multipleChoice
 ---

diff --git a/...ted/topics/slaveReparations_discussion.md → ...emo/topics/slaveReparations_discussion.md b/...ted/topics/slaveReparations_discussion.md → ...emo/topics/slaveReparations_discussion.md
@@ -1,5 +1,5 @@
 ---
-name: projects/example/demo_annotated/topics/slaveReparations_discussion.md
+name: demo/annotated_demo/topics/slaveReparations_discussion.md
 title: slaveReparations
 type: noResponse
 ---

diff --git a/...notated/topics/slaveReparations_survey.md → ...ed_demo/topics/slaveReparations_survey.md b/...notated/topics/slaveReparations_survey.md → ...ed_demo/topics/slaveReparations_survey.md
@@ -1,5 +1,5 @@
 ---
-name: projects/example/demo_annotated/topics/slaveReparations_survey.md
+name: demo/annotated_demo/topics/slaveReparations_survey.md
 title: slaveReparations
 type: multipleChoice
 ---

diff --git a/demo/simple_demo/README.md b/demo/simple_demo/README.md
@@ -0,0 +1 @@
+This is a simple demo study that you can copy and use as a starting point for your own study designs.
diff --git a/demo/simple_demo/dev.config.json b/demo/simple_demo/dev.config.json
@@ -0,0 +1,26 @@
+{
+  "batchName": "annotated_demo",
+  "cdn": "local",
+  "treatmentFile": "demo/simple_demo/simple_demo.treatments.yaml",
+  "customIdInstructions": "none",
+  "platformConsent": "US",
+  "consentAddendum": "none",
+  "checkAudio": true,
+  "checkVideo": true,
+  "introSequence": "default",
+  "treatments": ["simple_demo"],
+  "payoffs": "equal",
+  "knockdowns": "none",
+  "dispatchWait": 1,
+  "launchDate": "immediate",
+  "centralPrereg": false,
+  "preregRepos": [],
+  "dataRepos": [],
+  "videoStorage": "none",
+  "exitCodes": {
+    "complete": "MyCompleteExitCode",
+    "error": "MyErrorExitCode",
+    "lobbyTimeout": "MyTimeoutExitCode",
+    "failedEquipmentCheck": "MyFailedEquipmentCheckExitCode"
+  }
+}
diff --git a/demo/simple_demo/exit/exit_question.md b/demo/simple_demo/exit/exit_question.md
@@ -0,0 +1,11 @@
+---
+name: demo/simple_demo/exit/exit_question.md
+type: multipleChoice
+---
+
+## Did you have a good conversation?
+
+---
+
+- yes
+- no
diff --git a/demo/simple_demo/game/discussion_prompt.md b/demo/simple_demo/game/discussion_prompt.md
@@ -0,0 +1,8 @@
+---
+name: demo/simple_demo/game/discussion_prompt.md
+type: noResponse
+---
+
+# Please introduce yourself to your partner
+
+---
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		This is a simple demo study that you can copy and use as a starting point for your own study designs.