Neuraplay Dev Onboarding Guide

I want to hand new engineers a single, crystal-clear starting point for Neuraplay. Your task is to assemble a comprehensive onboarding package and starter repository that lets a React 18 + TypeScript front-end talk smoothly to a Node.js (CommonJS .cjs) back-end, a PostgreSQL database enhanced with pgvector, and real-time WebSockets—all while laying solid tracks for an eventual mobile release on both iOS and Android.

Here is what I need you to cover:

• Source-controlled starter code that builds and runs out of the box. The front-end should already include Zustand for state and Tailwind for styling; the back-end should expose at least one sample route, WebSocket channel, and pgvector-backed query.

• A step-by-step onboarding checklist (Markdown is fine) explaining local environment setup, repo structure, code conventions, branching model, lint/prettier rules, and the CI pipeline you wire in. Think of it as a living playbook—new hires clone, read, run, and immediately see green tests.

• Clear integration stubs for OpenAI and Fireworks AI so future LLM calls can be dropped in without re-plumbing dependencies.

• API gateway outlines (or mocks) for Health-app features: workout tracking, nutrition logging, and medical record handling. I do not expect the full feature set now, but I do want typed service wrappers and realistic sample JSON to prove the flow is thought through.

• A custom authentication module (JWT or session-based—your call) that demonstrates sign-up, login, refresh, and role handling. No third-party OAuth screens; we own the user system from day one.

• A concise “next steps” section listing the first real tickets a developer should pick up once they finish the checklist.

Deliverables are the Git repo link and the onboarding document. I will spin up the project on a fresh machine and follow your guide; everything should install, seed, and start without additional tweaks.