first commit of refactor

frontend/README.md

@@ -0,0 +1,38 @@
+# Koin Ping Frontend
+
+React + Vite frontend for the on-chain monitoring and alerting system.
+
+## Getting Started
+
+1. Install dependencies:
+   ```bash
+   npm install
+   ```
+
+2. Run the development server:
+   ```bash
+   npm run dev
+   ```
+
+3. Build for production:
+   ```bash
+   npm run build
+   ```
+
+4. Preview production build:
+   ```bash
+   npm run preview
+   ```
+
+## Project Structure
+
+- `src/api/` - API calls to backend
+- `src/components/` - Reusable UI components
+- `src/pages/` - Top-level page components
+- `src/utils/` - Utility functions
+- `public/` - Static assets
+
+## Development
+
+The frontend runs on port 3000 and proxies API requests to the backend running on port 5000.
+