HaloLight Ecosystem

HaloLight is a multi-framework, multi-platform admin dashboard solution. This document lists all projects and their status.

Project Overview

Frontend Framework Implementations

Project	Framework	Status	Description
halolight	Next.js 14 + React 18	✅ Released	Reference implementation
halolight-react	React + Vite	✅ Released	Pure SPA version
halolight-vue	Vue 3.5 + Vite	✅ Released	Vue reference implementation
halolight-angular	Angular 21	✅ Released	Angular implementation
halolight-nuxt	Nuxt 3	✅ Released	Vue SSR version
halolight-svelte	SvelteKit	✅ Released	Svelte implementation
halolight-astro	Astro	✅ Released	Static-first
halolight-solid	SolidJS	✅ Released	High-performance reactive
halolight-qwik	Qwik	✅ Released	Resumable
halolight-remix	Remix	✅ Released	Full-stack React
halolight-preact	Preact	✅ Released	Lightweight React
halolight-lit	Lit	✅ Released	Web Components
halolight-fresh	Fresh (Deno)	✅ Released	Deno native
halolight-deno	Fresh (Deno)	✅ Released	Deno implementation

Deployment Platforms

Project	Platform	Status	Features
halolight-cloudflare	Cloudflare Pages/Workers	✅ Released	Edge runtime, Next.js 15
halolight-vercel	Vercel	✅ Released	Edge Functions
halolight-netlify	Netlify	✅ Released	Edge Functions
halolight-aws	AWS Amplify	✅ Released	Lambda@Edge
halolight-azure	Azure Static Web Apps	✅ Released	Azure Functions
halolight-fly	Fly.io	✅ Released	Global deployment
halolight-railway	Railway	✅ Released	One-click deploy
halolight-docker	Docker self-hosted	✅ Released	Traefik reverse proxy

Backend APIs

Project	Tech Stack	Status	Features
halolight-api-nestjs	NestJS + Prisma + TypeScript	✅ Released	Node.js enterprise
halolight-api-node	Express + Prisma + TypeScript	✅ Released	Node.js reference implementation
halolight-api-go	Gin + GORM	✅ Released	High performance
halolight-api-python	FastAPI + SQLAlchemy + Alembic	✅ Released	Python ecosystem
halolight-api-bun	Hono + Drizzle ORM	✅ Released	Bun runtime
halolight-api-java	Spring Boot 3.4 + JPA	✅ Released	Enterprise Java
halolight-api-php	Laravel + Eloquent	✅ Released	PHP ecosystem

Infrastructure

Project	Purpose	Status	Features
halolight-bff	tRPC Gateway	✅ Released	Type-safe API
halolight-action	Next.js Full-stack	✅ Released	Server Actions
halolight-ui	Stencil Web Components	✅ Released	Cross-framework component library

AI & Web3

Project	Purpose	Status	Features
halolight-ai	AI Assistant	✅ Released	RAG + Action execution
halolight-web3	Web3 Integration	✅ Released	EVM + Solana + IPFS

Tech Stack Comparison

Frontend Frameworks

React family:     Next.js → Remix → Preact → React (Vite)
Vue family:       Vue 3.5 → Nuxt 3
Others:           Angular → SvelteKit → SolidJS → Qwik → Lit → Astro → Fresh → Deno

Backend Languages

Node.js:          NestJS (Prisma) → Express (Prisma) → Hono (Drizzle)
Go:               Gin (GORM)
Python:           FastAPI (SQLAlchemy)
Java:             Spring Boot (JPA)
PHP:              Laravel (Eloquent)

Deployment Platforms

Edge runtime:     Cloudflare → Vercel → Netlify
Cloud platforms:  AWS Amplify → Azure SWA → Fly.io → Railway
Self-hosted:      Docker + Traefik

Quick Start

Choose Frontend Framework

# React (Recommended)
git clone https://github.com/halolight/halolight
cd halolight && pnpm install && pnpm dev

# Vue
git clone https://github.com/halolight/halolight-vue
cd halolight-vue && pnpm install && pnpm dev

# Angular
git clone https://github.com/halolight/halolight-angular
cd halolight-angular && pnpm install && pnpm start

Choose Backend API

# Node.js (Recommended)
git clone https://github.com/halolight/halolight-api-node
cd halolight-api-node && pnpm install && pnpm dev

# Go
git clone https://github.com/halolight/halolight-api-go
cd halolight-api-go && go run main.go

# Python
git clone https://github.com/halolight/halolight-api-python
cd halolight-api-python && pip install -r requirements.txt && uvicorn main:app --reload

# Java
git clone https://github.com/halolight/halolight-api-java
cd halolight-api-java && mvn spring-boot:run

Choose Deployment Platform

# Cloudflare (Recommended for edge)
git clone https://github.com/halolight/halolight-cloudflare
cd halolight-cloudflare && pnpm install && pnpm deploy

# Docker (Recommended for self-hosted)
git clone https://github.com/halolight/halolight-docker
cd halolight-docker && docker-compose up -d

Component Library Usage

Install halolight-ui

npm install @halolight/ui

Use in HTML

<script type="module" src="https://unpkg.com/@halolight/ui/dist/halolight-ui.esm.js"></script>

<hl-button variant="primary">Click me</hl-button>
<hl-input label="Email" type="email"></hl-input>
<hl-card>
  <h3 slot="header">Card Title</h3>
  <p>Card content</p>
</hl-card>

Use in React

import { defineCustomElements } from '@halolight/ui/loader';
defineCustomElements();

function App() {
  return <hl-button variant="primary">Click me</hl-button>;
}

Use in Vue

<script setup>
import { defineCustomElements } from '@halolight/ui/loader';
defineCustomElements();
</script>

<template>
  <hl-button variant="primary">Click me</hl-button>
</template>

AI Assistant Integration

Deploy halolight-ai

git clone https://github.com/halolight/halolight-ai
cd halolight-ai
cp .env.example .env
# Configure OPENAI_API_KEY or other LLM keys
docker-compose up -d

API Calls

# Send message
curl -X POST http://localhost:3000/api/ai/chat \
  -H "Content-Type: application/json" \
  -H "X-Tenant-ID: default" \
  -H "X-User-ID: user1" \
  -d '{"message": "Help me analyze today'\''s data"}'

# Execute action
curl -X POST http://localhost:3000/api/ai/actions/execute \
  -H "Content-Type: application/json" \
  -d '{"action": "query_users", "params": {"role": "admin"}}'

Web3 Integration

Install Dependencies

# Core package
npm install @halolight/web3-core

# React components
npm install @halolight/web3-react

# Vue components
npm install @halolight/web3-vue

React Example

import { Web3Provider, WalletButton, TokenBalance } from '@halolight/web3-react';

function App() {
  return (
    <Web3Provider>
      <WalletButton />
      <TokenBalance />
    </Web3Provider>
  );
}

Contributing

1. Fork the repository
2. Create feature branch: git checkout -b feature/xxx
3. Commit changes: git commit -m 'feat: xxx'
4. Push branch: git push origin feature/xxx
5. Submit Pull Request

License

All HaloLight projects are licensed under MIT License.