Skip to content

Quick Start

Get AccessALI running in less than 5 minutes!

Choose Your Setup

# 1. Clone repository
git clone https://github.com/stratpoint-engineering/poc-access-ali.git
cd poc-access-ali

# 2. Copy environment file
cp .env.docker .env

# 3. Start services
cd src
pnpm docker:dev:build

# 4. Run migrations (in new terminal)
cd src
pnpm docker:db:migrate

# 5. Open application
open http://localhost:3000

# 1. Clone repository
git clone https://github.com/stratpoint-engineering/poc-access-ali.git
cd poc-access-ali/src

# 2. Install dependencies
pnpm install

# 3. Configure environment
cp ../documents/00-references/.env.example .env.local
# Edit .env.local with your DATABASE_URL

# 4. Run migrations
pnpm db:migrate

# 5. Start development server
pnpm dev

# 6. Open application
open http://localhost:3000

Verify Installation

1. Check Application

Navigate to http://localhost:3000

You should see the AccessALI login page.

2. Check Health Endpoint

curl http://localhost:3000/api/health

Expected response: 

{
  "status": "healthy",
  "timestamp": "2024-01-01T00:00:00.000Z",
  "database": "connected"
}

3. View Database

Open Prisma Studio:

# Docker
pnpm docker:db:studio

# Local
pnpm db:studio

Access at http://localhost:5555

Next Steps

Learn the Basics

  1. Project Structure - Understand the codebase
  2. Development Workflow - Daily development process
  3. Architecture Overview - System design

Make Your First Change

  1. Open src/app/page.tsx
  2. Edit the welcome message
  3. Save the file
  4. See changes automatically in browser

Explore Features

Common Issues

Port Already in Use

lsof -i :3000
kill -9 <PID>

Database Connection Failed

# Docker: Check logs
pnpm docker:logs:app

# Local: Verify DATABASE_URL
echo $DATABASE_URL

Hot-Reload Not Working

# Docker: Restart
pnpm docker:restart

# Local: Restart dev server
# Press Ctrl+C, then pnpm dev

Getting Help

What's Next?

Now that you have AccessALI running, explore: