A web application for searching through your Val Town vals using the Val Town API.

• Search through all your vals by name, content, or description
• Filter by val type (HTTP, cron, email, script)
• View val details including code content
• Direct links to edit vals in Val Town
• Real-time search with debouncing
• Responsive design with TailwindCSS

├── backend/
│   ├── index.ts             # Main Hono server
│   └── routes/
│       └── api.ts           # Val Town API integration
├── frontend/
│   ├── index.html           # Main HTML template
│   ├── index.tsx            # React frontend entry point
│   └── components/
│       ├── App.tsx          # Main app component
│       ├── SearchBar.tsx    # Search input component
│       ├── ValCard.tsx      # Individual val display
│       └── FilterBar.tsx    # Type filters
└── shared/
    └── types.ts             # Shared TypeScript types

1. Get your Val Town API token:

   • Go to Val Town API Settings
   • Create a new API token
   • Copy the token

2. Set the environment variable:

   • In your Val Town project, set VALTOWN_API_TOKEN to your API token
   • The app will automatically detect when the token is available

3. Access the app:

   • The app will be available at your HTTP endpoint
   • If the token isn't set, you'll see instructions on the homepage

• Search: Type in the search bar to find vals by name, content, or description
• Filter: Use the type filters to narrow results by val type (HTTP, cron, email, script)
• View Code: Each val card shows a preview of the code with syntax highlighting
• Quick Actions: Click "Run" to execute HTTP vals, or "Edit in Val Town" to modify them
• Real-time Search: Results update as you type with intelligent debouncing
• Keyboard Shortcuts: Press Cmd/Ctrl + K to quickly focus the search bar
• Clear Search: Click the × button or use the clear button to reset your search

• Search is case-insensitive and matches partial words
• Use specific terms to narrow down results quickly
• Filter by type to focus on specific kinds of vals
• The search looks through val names, code content, and descriptions
• Results show the total number of lines in each val
• Privacy levels are clearly indicated (public, private, unlisted)

• GET / - Serves the main application
• GET /api/vals - Search vals with query parameters:
  • q - Search query (optional)
  • type - Filter by val type (optional)
  • limit - Number of results (default: 50)