Quick Start

Get started with SmartFall in just a few minutes.

Prerequisites

• Node.js 18+ or later
• npm or yarn
• PostgreSQL database (or use Convex for serverless)
• Git

Installation

Clone the repository and install dependencies:

git clone https://github.com/your-org/smartfall.git
cd smartfall
npm install

Environment Setup

Copy the example environment file and configure it:

cp .env.example .env.local

See Environment Variables for detailed configuration.

Running Locally

Start the development server:

npm run dev

The application will be available at http://localhost:3000.

First Steps

1. Sign Up: Create an account at the signup page
2. Create a Patient Profile: If you're a caregiver, create a patient profile
3. Add a Device: Register your IoT device using the device management page
4. Monitor Falls: View fall events in the dashboard

Next Steps

• Learn about the Architecture
• Explore the API Reference
• Set up IoT Devices
• Deploy to Production

Troubleshooting

Port 3000 already in use

Use a different port:

npm run dev -- -p 3001

Database connection failed

Verify your DATABASE_URL in .env.local and ensure the database server is running.

Module not found errors

Clear node_modules and reinstall:

rm -rf node_modules package-lock.json
npm install

See the Installation guide for more details.