Skip to main content
This guide will help you get DoctorSoft+ running on your local development environment and create your first user account.

​
Prerequisites

Before you begin, ensure you have the following installed:
  • Node.js 18 or higher
  • npm (comes with Node.js)
  • A Supabase account and project
  • Git (for cloning the repository)
DoctorSoft+ requires Node.js 18 or higher. You can check your Node version by running node --version in your terminal.

​
Getting started

1

Clone the repository

Clone the DoctorSoft+ repository to your local machine:
git clone <your-repository-url>
cd DoctorSoft+
2

Install dependencies

Install all required npm packages:
npm install
This will install all dependencies including React, TypeScript, Vite, Supabase client, and other required packages.
3

Configure environment variables

Create a .env file in the root directory and add your Supabase credentials:
VITE_SUPABASE_URL=https://your-project.supabase.co
VITE_SUPABASE_ANON_KEY=your-anon-key
VITE_MAX_FILE_SIZE_MB=10
VITE_BUCKET_NAME=00000000-default-bucket
The Supabase URL and Anon Key are required. The application will not start without them.
You can find these values in your Supabase project dashboard under Settings > API.
4

Start the development server

Launch the Vite development server:
npm run dev
The application will be available at http://localhost:5173
Vite provides hot module replacement (HMR), so changes to your code will be reflected immediately in the browser.
5

Create your first user account

Open your browser and navigate to http://localhost:5173. You’ll see the login page.
  1. Click on “Registrarse” (Register) to create a new account
  2. Fill in the registration form with the following information:
    • Full name (minimum 2 characters)
    • Email address
    • Password (must meet strength requirements)
    • Confirm password
  3. Accept the terms and conditions
  4. Click “Crear Cuenta” (Create Account)
Password requirements:
  • Minimum 8 characters
  • At least one uppercase letter
  • At least one lowercase letter
  • At least one number
  • At least one special character
6

Verify your email

After registration, check your email inbox for a verification email from Supabase. Click the verification link to activate your account.
You must verify your email before you can log in to DoctorSoft+.
7

Log in to DoctorSoft+

Return to the login page and enter your credentials:
// The login process uses Supabase authentication
const { error } = await supabase.auth.signInWithPassword({
  email: data.email,
  password: data.password,
});
After successful login, you’ll be redirected to the main dashboard.

​
What’s next?

Now that you have DoctorSoft+ running locally, you can:
  • Explore the medical practice management features
  • Configure additional settings in the admin panel
  • Set up your practice information and staff accounts
  • Learn about deployment options for production

​
Troubleshooting

​
Supabase connection error

If you see a Supabase connection error, verify:
  1. Your environment variables are set correctly in .env
  2. Your Supabase project is active
  3. Your internet connection is working
  4. The Supabase URL and Anon Key are valid
// DoctorSoft+ validates environment variables at startup
if (!supabaseUrl || !supabaseKey) {
  throw new Error('Faltan las variables de entorno de Supabase. Revisa tu archivo .env.');
}

​
Email not confirmed error

If you see “Por favor confirme su correo electrónico antes de iniciar sesión”, check your email inbox and spam folder for the verification email from Supabase.

​
Port already in use

If port 5173 is already in use, Vite will automatically try the next available port. Check the terminal output for the actual URL.

​
Getting help

If you encounter any issues not covered in this guide:

Build docs developers (and LLMs) love

Get started for freeTalk to us