Geekle Admin App

This is the administration application for the Geekle platform. It provides interfaces for managing organizations, users, applications, and other administrative tasks.

Prerequisites

• Node.js (v18 or higher)
• npm (v7 or higher)

Getting Started

Installation

1. Clone the repository:

   git clone <repository-url>
   cd geekle-admin-app

2. Install dependencies:

   npm install

Environment Variables

The application uses several environment variables to configure service endpoints. Create a .env file in the root directory with the following variables:

# Service Endpoints
VITE_USER_ADMIN_SERVICE=https://user-admin-service-u4q6fb7vaq-an.a.run.app
VITE_AUTH_SERVICE=https://auth-admin-service-u4q6fb7vaq-an.a.run.app
VITE_ORGANIZATION_SERVICE=https://organization-service-u4q6fb7vaq-an.a.run.app
VITE_CATALOG_SERVICE=https://catalog-service-u4q6fb7vaq-an.a.run.app
VITE_CHAT_SERVICE=https://chat-service-u4q6fb7vaq-an.a.run.app
VITE_ORDER_SERVICE=https://order-service-u4q6fb7vaq-an.a.run.app

Note: The default values are provided in the code, but you can override them with your own endpoints if needed.

Development

Running the Development Server

To start the development server:

npm run dev

This will start the application in development mode. Open http://localhost:5173 to view it in the browser.

Building for Production

To build the application for production:

npm run build

The build artifacts will be stored in the dist/ directory.

Running a Production Preview

To preview the production build locally:

npm run preview

Code Quality

Linting

To run the linter:

npm run lint

To automatically fix linting issues:

npm run lint:fix

Type Checking

To run TypeScript type checking:

npm run typecheck

Project Structure

• src/ - Source code
  • components/ - Reusable UI components
  • constants/ - Application constants and configuration
  • pages/ - Page components
  • routes/ - Route definitions
  • types/ - TypeScript type definitions
  • utils/ - Utility functions

Features

• Organization management
• User management
• Application review and approval
• Settings management

Troubleshooting

Common Issues

1. API Connection Issues: Ensure that the environment variables are correctly set and that you have access to the specified endpoints.

2. Build Errors: Make sure all dependencies are installed correctly with npm install.

3. Type Errors: Run npm run typecheck to identify and fix type issues.

Contributing

1. Ensure your code follows the project's coding standards
2. Run linting and type checking before submitting changes
3. Make sure all imports are properly sorted (ESLint will auto-fix this with npm run lint:fix)