Boost Accelerometer Data Application

Table of Contents

• Installation
• Usage

---

Installation

🛠️ Local Setup Instructions

These steps will walk you through installing Git, Docker Desktop, and running the web application locally using Docker.

---

Check if Git is Installed

Open a terminal (or powershell for Windows) and run:

git --version

If you see something like git version 2.40.1, Git is already installed. If you get an error like command not found, continue below.

---

🧰 Install Git (if not already installed)

🔵 macOS

brew install git

Or download it from the official installer:

👉 https://git-scm.com/download/mac

🟦 Windows

Use the below link to install Git for Windows. During installation, you can accept the default options. https://github.com/git-for-windows/git/releases/download/v2.49.0.windows.1/Git-2.49.0-64-bit.exe

🟢 Linux (Debian/Ubuntu)

sudo apt update
sudo apt install git

Verify Git is working:

git --version

---

🐳 Install Docker Desktop

🔗 Download Links: • macOS/Windows: https://www.docker.com/products/docker-desktop • Linux (Desktop GUI): https://docs.docker.com/desktop/install/linux-install/

🚧 During Installation: 1. Accept the Terms of Service 2. Allow any OS-level permissions or system extensions 3. Log in or create a Docker Hub account (free) 4. Once installed, open Docker Desktop and leave it running in the background

To confirm Docker is running:

docker --version

If Docker is not found, try restarting your terminal or logging out and back in.

⸻

⬇️ Clone the Repository

In your terminal:

git clone https://github.com/HBClab/boost-act-js.git
cd boost-act-js

⸻

5. 🚀 Build and Run the App with Docker

Make sure Docker Desktop is still running.

🛠️ Build the image:

docker build -t act .

If you are having trouble with this step try the following:

1. Make sure your verified your email with docker. If you have not, it will not let you complete this step.
2. Make sure the docker app is running.
3. If none of these work, shoot me an email with the terminal output of this step!

▶️ Run the container:

docker run -p 3000:3000 act

---

You can now access the app at:

🌐 http://localhost:3000

---

Usage

The app is designed to support two main workflows:

1. Search by Study ID
   Quickly locate individual participants by entering their study ID (e.g., 8001) into the search bar.

2. Filter by Criteria
   Use filters to find subsets of participants that meet specific site or study criteria.

---

🧭 Using the Interface

• 🏠 Use the search bar on the Home page or any Results page to look up participants by ID.
• 🧇 Click the waffle icon in the top-right corner at any time to open the filter slider and refine your view.

Updating

📁 Step 1: Make sure you’re one level above the boost-act-js folder

🖼️ Visual guide:

YourProjectFolder/
├── boost-act-js/     ← This is the folder to delete
└── (other stuff)

If you’re inside the folder now:

cd ..

⸻

🗑️ Step 2: Remove the boost-act-js folder completely

On Windows PowerShell:

Remove-Item -Recurse -Force .\boost-act-js\

On macOS/Linux (in Terminal):

rm -rf ./boost-act-js

⸻

📥 Step 3: Clone the latest clean version

git clone https://github.com/HBClab/boost-act-js.git
cd boost-act-js

⸻

🧱 Step 4: Rebuild the Docker image

docker build -t act .

⸻

▶️ Step 5: Run the container

docker run -p 3000:3000 act

⸻

🟢 You should now see the app running at: 🌐 http://localhost:3000

## FEATURE REQUESTS
- [ ] sort by activity types
    - HC