relaylist-frontend

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

relaylist-frontend

★ 10 Open GitHub ↗

The frontend for https://RelayList.com

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

## Relay List Frontend

This is the frontend for [RelayList.com](https://relaylist.com). The backend can be found at [relaylist-api](https://github.com/mlapida/relaylist-api). The site uses Next.js and is hosted on Cloudflare Pages.

## Development

### Prerequisites
- Node.js 20.x or 22.x (recommended for compatibility)
- npm

### Getting Started

1. Clone the repository
2. Install dependencies:
   ```bash
   npm install
   ```
3. Set up environment variables:
   ```bash
   cp .env.local.example .env.local
   ```
   Edit `.env.local` with your configuration if needed.
4. Start the development server:
   ```bash
   npm run dev
   ```
5. Open [http://localhost:3000](http://localhost:3000) in your browser

### Available Scripts

- `npm run dev` - Start development server
- `npm run build` - Build for production
- `npm run start` - Start production server
- `npm run lint` - Run ESLint
- `npm run pages:build` - Build for Cloudflare Pages
- `npm run pages:deploy` - Deploy to Cloudflare Pages
- `npm run pages:dev` - Development build with Cloudflare optimizations

## Environment Variables

The application uses environment variables for configuration:

### Required Variables
- `NEXT_PUBLIC_API_BASE_URL` - Base URL for the RelayList API (default: https://api.relaylist.com)

### Optional Variables
- `NEXT_PUBLIC_API_TIMEOUT` - API request timeout in milliseconds (default: 10000)

### Environment Files
- `.env.local.example` - Example configuration file
- `.env.local` - Local development overrides (not committed)
- `.env.production` - Production environment configuration

## Deployment

The site is deployed to Cloudflare Pages. See [CLOUDFLARE.md](./CLOUDFLARE.md) for detailed deployment instructions and configuration.

### Quick Deployment Settings
- **Build command:** `npx @cloudflare/next-on-pages`
- **Output directory:** `/.vercel/output/static`
- **Node.js version:** 20.x

## Architecture

- **Framework:** Next.js 15.4.5
- **UI Library:** React Bootstrap
- **Data Table:** react-data-table-component
- **HTTP Client:** Axios
- **Date/Time:** Moment.js
- **Hosting:** Cloudflare Pages

## Security & Performance

- Content Security Policy (CSP) headers configured
- Security headers (X-Frame-Options, X-Content-Type-Options, etc.)
- React performance optimizations (memo, useMemo, useCallback)
- Accessibility improvements (ARIA labels, semantic HTML)
- Input validation for API responses

## Documentation

- [CLAUDE.md](./CLAUDE.md) - Development guidance for AI assistants
- [TODO.md](./TODO.md) - Project roadmap and improvements
- [CLOUDFLARE.md](./CLOUDFLARE.md) - Deployment instructions

relaylist-frontend

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README