feat: initial commit — Acoustic Data Link FSK transmitter/receiver app

Author: Asmithcodes

.env.example

@@ -0,0 +1,5 @@
+# Rename this file to .env for local development
+# NEVER commit the actual .env file to version control.
+
+VITE_API_KEY=your_google_gemini_api_key_here
+VITE_APP_MODE=development

.github/workflows/deploy.yml

@@ -0,0 +1,53 @@
+name: Deploy to GitHub Pages
+
+on:
+  push:
+    branches:
+      - main
+      - master
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: true
+
+jobs:
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: 'npm'
+          
+      - name: Install dependencies
+        run: npm ci
+        
+      - name: Build
+        run: npm run build
+        env:
+          # VITE_API_KEY: ${{ secrets.VITE_API_KEY }}
+          basename: /transmit-via-sound/
+          
+      - name: Setup Pages
+        uses: actions/configure-pages@v4
+        
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: './dist'
+          
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -0,0 +1,30 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+node_modules
+dist
+dist-ssr
+*.local
+
+# Editor directories and files
+.vscode/*
+!.vscode/extensions.json
+.idea
+.DS_Store
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?
+
+# Dev scratch / build output files
+build_output.txt
+ts_errors.txt
+tsc_errors.log
+prd.md.resolved

README.md

@@ -0,0 +1,53 @@
+# Acoustic Data Link
+
+A browser-based acoustic data transmission app that enables devices to transmit data to each other using only sound (speakers and microphones).
+
+**Visual Metaphor**: "Deep Space Digital Radio". The interface borrows elements from high-frequency radio dashboards and cryptography terminals, employing an immersive animated aurora background with dark, glass-morphic hardware telemetry panels, a fixed primary green accent for optimal visual contrast, and decrypted text animations. 
+
+*Developed by Asmith — asmyth@duck.com*
+
+## Features (Phase 1: Frontend Architecture)
+- **Role Selection:** Toggle instantly between Transmitter and Receiver dashboards.
+- **Transmitter Dashboard:** Mock configurations for FSK encoding profiles, bitrate targets, and redundancy levels, with full aesthetic waveform telemetry.
+- **Receiver Dashboard:** Mock listening states, ambient audio spectrum visualization, and signal decoding console logs.
+- **Kinetic UI:** Smooth transitions and reactive elements via Framer Motion. 
+- **Anti-Gravity Architecture:** Full `prefers-reduced-motion` accessibility support, API fallback override mockups, and strict React state separation.
+
+## Setup Instructions
+
+### Prerequisites
+- Node.js (v18+)
+- npm or yarn
+
+### Installation
+1. Clone the repository
+2. Install dependencies:
+   \`\`\`bash
+   npm install
+   \`\`\`
+3. Start the development server:
+   \`\`\`bash
+   npm run dev
+   \`\`\`
+
+## Deployment Guide
+
+### GitHub Pages (Automated)
+This repository includes a GitHub Action for deploying natively to GitHub Pages.
+1. Push your code to the \`main\` branch.
+2. In your repository settings:
+   - Go to **Settings** > **Pages**.
+   - Set the source to **GitHub Actions**.
+3. *Phase 2 Only:* Add \`VITE_API_KEY\` to your Repository Secrets if the AI summarization fallback is necessary.
+
+### Netlify Deployment
+1. Connect your repository to Netlify.
+2. The included \`netlify.toml\` handles the build command (\`npm run build\`) and SPA routing redirects automatically.
+3. *Phase 2 Only:* Add the \`VITE_API_KEY\` environment variable in the Netlify site settings.
+
+## API Override System
+To protect production stability and reduce quota exhaustion, an Override System is implemented. If the backend services experience rate-limiting (`429`) or a key expiration, the UI intercepts the error and displays a modal.
+Users can input their own Google SDK API keys dynamically to bypass the server limitations and continue transmitting data.
+
+---
+> Note: Replace the default Vite favicon in `public/` to match the radio/acoustic transmission metaphor.

eslint.config.js

@@ -0,0 +1,23 @@
+import js from '@eslint/js'
+import globals from 'globals'
+import reactHooks from 'eslint-plugin-react-hooks'
+import reactRefresh from 'eslint-plugin-react-refresh'
+import tseslint from 'typescript-eslint'
+import { defineConfig, globalIgnores } from 'eslint/config'
+
+export default defineConfig([
+  globalIgnores(['dist']),
+  {
+    files: ['**/*.{ts,tsx}'],
+    extends: [
+      js.configs.recommended,
+      tseslint.configs.recommended,
+      reactHooks.configs.flat.recommended,
+      reactRefresh.configs.vite,
+    ],
+    languageOptions: {
+      ecmaVersion: 2020,
+      globals: globals.browser,
+    },
+  },
+])

index.html

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/svg+xml" href="/vite.svg" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>transmit-via-sound</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

netlify.toml

@@ -0,0 +1,9 @@
+[build]
+publish = "dist"
+command = "npm run build"
+
+# CRITICAL: Fix for Single Page Application (SPA) Routing
+[[redirects]]
+from = "/*"
+to = "/index.html"
+status = 200