Skip to main content
After completing installation, environment setup, and database configuration, you’re ready to run Biovity locally.

​
Start the development server

1

Run the dev command

Start the Next.js development server with Turbopack:
bun dev
Biovity uses Turbopack for fast refresh and optimized builds. The --turbopack flag is configured in package.json.
2

Wait for compilation

Wait for the initial compilation to complete. You should see output similar to:
▲ Next.js 16.1.1 (turbopack)
- Local:        http://localhost:3000
- Network:      http://192.168.1.x:3000

✓ Ready in 2.3s
3

Open in browser

Open your browser and navigate to:
http://localhost:3000
You should see the Biovity landing page.

​
Available routes

Once running, you can access these routes:

​
Public pages

  • / - Home page (landing)
  • /empresas - Companies page
  • /nosotros - About us
  • /trabajos - Public job board
  • /salarios - Salary information

​
Authentication

  • /login - User and organization login
  • /register - User and organization registration

​
Dashboard (requires authentication)

  • /dashboard/employee - Employee dashboard home
  • /dashboard/employee/search - Job search
  • /dashboard/employee/applications - Job applications
  • /dashboard/employee/my-applications - User’s applications
  • /dashboard/employee/saved - Saved jobs
  • /dashboard/employee/messages - Messaging
  • /dashboard/employee/calendar - Calendar integration
  • /dashboard/employee/profile - User profile
  • /dashboard/employee/metrics - User analytics
  • /dashboard/admin - Admin dashboard

​
Development tools

While developing, you can use these commands:

​
Code quality

# Run linter
bun lint

# Format code
bun format

# Auto-fix issues
bun check

# Type check
bun typecheck

​
Build for production

# Build production bundle
bun build

# Start production server
bun start

​
Code style enforcement

Biovity uses Biome for linting and formatting with strict rules:
  • Line width: 100 characters
  • Semicolons: as needed
  • Recommended rules enabled
  • No unused variables (warning)
  • No explicit any (error)
Run bun check before committing to ensure your code passes all quality checks.

​
Hot reload

Turbopack provides fast refresh during development:
  • Save a file - Changes appear instantly in the browser
  • Add a component - Auto-detected and compiled
  • Fix errors - Error overlay shows detailed information

​
Accessing the API

Better Auth API routes are available at: 
http://localhost:3000/api/auth/*
The authentication endpoint is configured in app/api/auth/[...all]/route.ts.

​
Troubleshooting

​
Port already in use

If port 3000 is already in use, specify a different port: 
bun dev --port 3001

​
Database connection errors

  • Verify PostgreSQL is running
  • Check DATABASE_URL in .env.local
  • Ensure database exists and is accessible

​
Authentication errors

  • Verify BETTER_AUTH_SECRET is set in .env.local
  • Check BETTER_AUTH_URL matches your local URL
  • Ensure database migrations have run

​
Module not found errors

  • Clear cache and reinstall dependencies: 
    rm -rf node_modules .next
bun install

​
Development workflow

  1. Start dev server - bun dev
  2. Make changes - Edit files in app/, components/, or lib/
  3. Check browser - Changes appear automatically
  4. Run quality checks - bun check and bun typecheck
  5. Commit changes - Follow commit conventions

​
Next steps

Now that you have Biovity running locally: