Skip to main content

​
Quickstart Guide

Get your SIGEAC (Sistema de Gestión Aeronáutica Civil) instance up and running in minutes. This guide will walk you through installation, configuration, and your first login.

​
Prerequisites

Before you begin, ensure you have the following installed:
  • Node.js 20.x or higher - Download
  • npm, yarn, pnpm, or bun - Package manager of your choice
  • Git - For cloning the repository
SIGEAC is built with Next.js 14.2.14 and requires Node.js 20 or higher for optimal performance.

​
Installation

1

Clone the Repository

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

Install Dependencies

Install all required dependencies using your preferred package manager:
npm install
The installation includes 50+ dependencies including React 18, TanStack Query, Radix UI components, and more.
3

Configure Environment Variables

Create a .env.local file in the root directory and add your configuration:
# API Configuration
NEXT_PUBLIC_API_BASE_URL=https://your-api-domain.com/api

# Storage Configuration
NEXT_PUBLIC_STORAGE_BASE_URL=https://your-storage-domain.com/

# Reverb WebSocket Configuration (Optional)
NEXT_PUBLIC_REVERB_APP_KEY=your-reverb-app-key
NEXT_PUBLIC_REVERB_HOST=your-reverb-host
NEXT_PUBLIC_REVERB_SCHEME=https
The NEXT_PUBLIC_API_BASE_URL is required for SIGEAC to communicate with the backend API. Without it, the application will not function properly.
4

Start the Development Server

Launch the development server:
npm run dev
The application will start on http://localhost:3000
5

Access the Application

Open your browser and navigate to http://localhost:3000You’ll see the SIGEAC landing page with an animated airplane and a “Iniciar Sesión” (Login) button.

​
First Login

Once the application is running, you can access the login page:
  1. Click the “Iniciar Sesión” button on the landing page
  2. You’ll be redirected to /login
  3. Enter your credentials provided by your system administrator
  4. After successful authentication, you’ll be redirected to the main dashboard at /inicio
SIGEAC uses cookie-based authentication with JWT tokens. The auth_token cookie is automatically managed by the application.

​
What’s Next?

Now that you have SIGEAC running, explore these resources:

Installation Guide

Detailed installation instructions and troubleshooting

Architecture

Learn about SIGEAC’s architecture and technology stack

Configuration

Configure SIGEAC for your organization

API Reference

Explore the backend API endpoints

​
Key Features Accessible After Login

Once logged in, you’ll have access to:
  • Dashboard (/inicio) - Main overview of your aviation operations
  • SMS Module - Safety Management System for aviation compliance
  • Maintenance - Aircraft maintenance tracking and management
  • General Operations - Inventory, scheduling, and resource management
  • Airline Management - Flight operations and crew scheduling
  • Settings (/ajustes) - User preferences and system configuration

​
Troubleshooting

​
Port Already in Use

If port 3000 is already in use, you can specify a different port: 
PORT=3001 npm run dev

​
API Connection Issues

If you’re unable to connect to the API:
  1. Verify your NEXT_PUBLIC_API_BASE_URL is correct
  2. Ensure the backend API is running and accessible
  3. Check that CORS is properly configured on the backend
  4. Verify the skip_zrok_interstitial header is supported by your API

​
Authentication Errors

If you’re experiencing authentication issues:
  1. Clear your browser cookies
  2. Ensure the backend is issuing valid JWT tokens
  3. Check that the auth_token cookie is being set correctly
  4. Verify the backend responds to Bearer token authentication
For more detailed troubleshooting, see the Installation Guide section.

Build docs developers (and LLMs) love

Get started for freeTalk to us