Skip to content

Commit de3db01

Browse files
authored
Add faq clarification (#222)
1 parent f29fc39 commit de3db01

1 file changed

Lines changed: 7 additions & 0 deletions

File tree

docs/faq.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -68,7 +68,14 @@ A: ReVISit has built-in error handling so your study can still run even if somet
6868
### Q: How can I ensure balanced numbers of participants between conditions in my between subjects study design?
6969

7070
A: There are several strategies to ensure balanced participant numbers between conditions in your between subjects study design using reVISit:
71+
7172
1. **Assigning participants to conditions via URL parameters**: You can assign participants to specific conditions via URL parameters using [study conditions](../designing-studies/sequences/url-conditions/). This enables you to create custom recruitment links for each condition, making it easier to control participant distribution.
7273
1. **Latin square design**: As described in the [Study Sequences documentation](../designing-studies/sequences/study-sequences/#latin-square), you can use Latin square sequences to systematically vary the order of conditions across participants. This helps ensure that each condition appears in each position equally often. However, be aware that if participants drop out or are rejected, this can affect the balance (see the documentation of [Latin squares](../designing-studies/sequences/study-sequences/#latin-square) for more details).
7374
1. **Random assignments**: If you are recruiting a large number of participants, random assignment to conditions can help achieve balance over time. While this method may not guarantee perfect balance at any given moment, it tends to even out as more participants are added. This is a viable option when strict balancing is less critical.
7475
1. **Setting up separate studies**: When precise control is needed, consider setting up separate studies for each condition. This allows you to monitor and control the number of participants in each condition directly. However, this comes at the cost of increased administrative overhead (e.g., separate recruitment links, separate datasets, separate specifications).
76+
77+
### Q: Why does my participant data appear on the deployed site but not in my local dashboard?
78+
79+
A: The technical answer is that when running locally with yarn serve, reVISIT prefixes all Firestore collections with dev-, while the deployed production site uses prod-. This means your local dashboard will look for data in dev-<studyId> and won't find data collected by the production site, which is stored under prod-<studyId>.
80+
81+
To view production data locally, run `yarn build && npx vite preview` instead of yarn serve. Note that setting NODE_ENV=production will not fix this, as the prefix is driven by Vite's import.meta.env.DEV flag, which is only set to false when running a production build.

0 commit comments

Comments
 (0)