Veld 🌾

Where ideas roam free

Veld is a lightweight, cross-platform system tray application that brings AI assistance directly to your fingertips. With a simple keyboard shortcut, access powerful AI tools anywhere on your system.

✨ Features

• 🚀 Instant Access: Press Ctrl+Shift+Space to summon Veld from anywhere
• 🎯 Pre-configured Tools: /summarize, /translate, /explain, /code, /refactor
• 🧠 Context-Aware: Automatically reads from your clipboard
• 💨 Streamlined Responses: Real-time AI streaming for faster results
• 🎨 Beautiful UI: Minimalist design with dark/light themes
• 🔒 Privacy-First: Your data stays yours

🎨 Design Philosophy

Like an open veld (prairie), Veld provides an expansive space for your thoughts to flow freely. No clutter, no distractions—just pure AI assistance when you need it.

🚀 Quick Start

Prerequisites

• Rust (latest stable)
• Node.js (v18+)
• pnpm

Installation & Setup

git clone https://github.com/yourusername/veld.git
cd veld
cargo install dioxus-cli
pnpm install

Development

In VSCode, press Ctrl+Shift+B and select "Run Dev Setup"

Building for Production

pnpm build  # Compiles TailwindCSS app → + Rust target/

## 📚 Learning Path

New to Dioxus 0.7? Follow this progressive learning path:

### Phase 1: Basic Setup (30-60 minutes)
- [ ] Understand Dioxus project structure
- [ ] Set up basic desktop application
- [ ] Create simple UI with button and counter
- [ ] Learn component-based UI development

### Phase 2: Interactive Features (1-2 hours)
- [ ] Add form inputs and state management
- [ ] Implement basic styling
- [ ] Practice Rust GUI patterns

### Phase 3: System Integration (2-3 hours)
- [ ] Integrate system tray functionality
- [ ] Register global shortcuts
- [ ] Add AI client capabilities
- [ ] Build pre-configured tools

### Learning Goals
- Master Dioxus 0.7 fundamentals
- Understand desktop app development patterns
- Build real-world cross-platform applications
- Integrate system-level features (tray, shortcuts)

### Resources
- [Dioxus 0.7 Documentation](https://dioxuslabs.com/learn/0.7/)
- [Dioxus GitHub](https://github.com/DioxusLabs/dioxus)
- [Development Progress](PROGRESS.md)

## 🎯 Use Cases

- **Developers**: Explain code, generate snippets, refactor functions
- **Writers**: Summarize articles, translate text, improve clarity
- **Researchers**: Analyze papers, extract key insights
- **Anyone**: Quick AI assistance without opening a browser

## 🔮 Roadmap

- [ ] System tray with global shortcuts
- [ ] AI client integration (OpenAI, Anthropic, Local)
- [ ] Pre-configured tool suite
- [ ] Customizable workflows
- [ ] Plugin system for extensions

## 🤝 are welcome! Feel free to submit Contributing

Contributions issues and pull requests.

## 📝 License

MIT License - see [LICENSE](LICENSE) for details.

---

**Made with ❤️ by developers, for developers**

*Veld - Where ideas roam free* 🌾