SampleFlow Tracker

SampleFlow Tracker is a lightweight web app for academic or personal sample tracking workflows. It replaces ad hoc spreadsheet tracking with a structured intake form, status fields, priority tags, timestamps, filters, and a small dashboard for queue visibility.

Features

• Track sample ID, project, sample type, owner, priority, status, received date, due date, and notes.
• View dashboard metrics for open samples, completed samples, rush priority items, and average turnaround.
• Review queue breakdown by status and workload by owner.
• Search, filter, sort, edit, delete, and update status inline.
• Import and export CSV files for spreadsheet-friendly workflows.
• Persist records locally in the browser with localStorage.
• Run as a static site with no build step or external dependencies.

Project Structure

.
├── index.html
├── package.json
├── README.md
├── server.js
├── .gitignore
└── src/
    ├── app.js
    └── styles.css

Run Locally

Open index.html directly in a browser, or run the local server:

npm start

Then open:

http://localhost:4173/

You can use a different port:

node server.js 5000

Demo Images

Checks

Run the JavaScript syntax check:

npm run check

GitHub Pages

This project is ready for GitHub Pages because index.html lives at the repository root.

1. Push the repository to GitHub.
2. Go to repository Settings > Pages.
3. Set the source to the default branch and root folder.
4. Save, then open the published Pages URL after deployment finishes.

Push to GitHub

Create an empty GitHub repository first, then run these commands from this project folder:

git init
git add .
git commit -m "Initial commit"
git branch -M main
git remote add origin https://github.com/YOUR-USERNAME/YOUR-REPOSITORY.git
git push -u origin main

Notes

Data is stored in the current browser only. Use CSV export to back up or move records between browsers/devices.