Skip to content

neekware/btc

Repository files navigation

ehAyeβ„’ Engine (bTc) - Between the Clicks

ehAye Logo

A complete web portal for your AI Automation with Vision and Control

CI TypeScript Next.js License

Live Demo | Documentation | Report Bug

Deploy with Vercel


🎯 What is Betsey (bTc)?

Betsey (Between the Clicks) is a comprehensive test target application designed to validate and showcase the capabilities of the ehAyeβ„’ Engine - an AI-powered browser automation system. This app serves as a real-world testing ground for automation tools, providing diverse UI components and interaction patterns.

Why "Between the Clicks"?

In the world of browser automation, the magic happens between the clicks - the waiting, the validation, the smart decision-making. Betsey provides the perfect playground to test these nuanced interactions.

✨ Key Features

  • πŸ€– AI-Ready: Designed specifically for AI automation testing
  • 🎨 Modern Stack: Next.js 15, React 19, Tailwind CSS v4
  • πŸŒ“ Theme Support: Beautiful dark/light themes with smooth transitions
  • πŸ“± Fully Responsive: Works on all devices and screen sizes
  • ⚑ Optimized Performance: Fast loading and smooth interactions
  • πŸ§ͺ Comprehensive Tests: Every UI pattern you need to test

πŸš€ Quick Start

# Clone the repository
git clone https://github.com/neekware/btc.git
cd btc

# Install dependencies
pnpm install

# Start development server
pnpm dev

Visit http://localhost:3333 to see Betsey in action!

🧩 Test Scenarios

Input Tests

  • πŸ“ Text Inputs - All input types, validations, and edge cases
  • πŸ“‹ Form Submit - Complex forms with various submission patterns
  • βœ… Checkboxes - Single, groups, indeterminate states
  • πŸ”˜ Radio Buttons - Groups, default selections, dynamic options
  • πŸ“Š Dropdowns - Native selects, custom dropdowns, multi-select
  • 🎚️ Sliders & Range - Value ranges, steps, and constraints

Interaction Tests

  • πŸ–±οΈ Click Events - Buttons, links, and clickable elements
  • ✨ Hover Effects - Mouse interactions and tooltips
  • 🎯 Focus & Blur - Tab navigation and focus management
  • πŸ“œ Scrolling - Infinite scroll, scroll-to-top, parallax
  • 🧭 Navigation - Routing, breadcrumbs, and menus
  • πŸ” Search - Real-time search with debouncing

Quick Test Elements

Try these interactive elements right on the home page:

  • Click Me - Test basic click handling
  • Secondary - Alternative action testing
  • Destructive - Confirmation dialogs
  • Outline - Different button styles
  • Ghost - Subtle interactions

πŸ“š Documentation

Project Structure

btc/
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ app/           # Next.js App Router
β”‚   β”œβ”€β”€ pages/         # Page components
β”‚   β”œβ”€β”€ components/    # UI components
β”‚   β”‚   β”œβ”€β”€ ui/        # Base components
β”‚   β”‚   └── ...        # Feature components
β”‚   β”œβ”€β”€ lib/           # Utilities
β”‚   β”œβ”€β”€ hooks/         # Custom hooks
β”‚   └── styles/        # Global styles
β”œβ”€β”€ public/            # Static assets
β”œβ”€β”€ scripts/           # Build tools
└── .github/           # CI/CD workflows

Available Scripts

# Development
pnpm dev          # Start dev server (port 3333)
pnpm build        # Build for production
pnpm start        # Start production server

# Code Quality
pnpm lint         # Check code issues
pnpm lint:fix     # Fix code issues
pnpm format       # Format code
pnpm typecheck    # Type checking

# Utilities
pnpm clean        # Clean build files

πŸ€– Using with ehAyeβ„’ Engine

Betsey is designed to work seamlessly with the ehAyeβ„’ Engine MCP (Model Context Protocol) for browser automation:

// Example automation script
await ehaye.navigate("https://btc.eh-aye.net");
await ehaye.click("text=Text Inputs");
await ehaye.fill("#username", "[email protected]");
await ehaye.press("Tab");
await ehaye.type("SecurePassword123!");
await ehaye.click('button[type="submit"]');

πŸ› οΈ Tech Stack Details

  • Framework: Next.js 15.5 with Pages Router
  • UI Library: React 19.1
  • Styling: Tailwind CSS v4 (oklch colors)
  • Components: Custom components with Radix UI
  • Animations: Framer Motion
  • Icons: Lucide React
  • Type Safety: TypeScript 5.9
  • Code Quality: ESLint, Prettier, Husky

🀝 Contributing

We welcome contributions! Please follow these steps:

  1. Fork the repository
  2. Create your feature branch (git checkout -b feat/amazing-feature)
  3. Commit changes (git commit -m 'feat: add amazing feature')
  4. Push to branch (git push origin feat/amazing-feature)
  5. Open a Pull Request

Commit Convention

  • feat: New features
  • fix: Bug fixes
  • docs: Documentation
  • style: Code style changes
  • refactor: Code refactoring
  • test: Test changes
  • chore: Maintenance

πŸ“„ License

MIT License - see LICENSE for details

πŸ™ Acknowledgments

πŸ“ž Get in Touch


ehAyeβ„’ Engine - AI Automation with Vision and Control

Β© 2006-2025 Neekware Inc. All rights reserved.

About

Between the Clicks MCP Automation with Vision and Control.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors