Skip to content

mobeen-asghar/VoiceProj

Repository files navigation

🎀 VoiceProj - Voice-Activated Project Management Tool

The future of project management is here - just speak your mind!

React TypeScript Tailwind CSS Vite License: MIT

πŸš€ What is VoiceProj?

VoiceProj revolutionizes project management by bringing natural voice commands to your workflow. No more clicking through endless menus or typing repetitive commands - just speak naturally and watch your projects come to life!

✨ Key Features

  • πŸŽ™οΈ Natural Voice Commands - Create tasks, manage projects, and navigate with your voice
  • 🎨 Neo-Brutalism Design - Bold, accessible, and visually striking interface
  • πŸ‘₯ Team Collaboration - Share projects and collaborate with team members
  • 🌍 Multi-language Support - Works in 25+ languages
  • πŸ“± Responsive Design - Perfect on desktop, tablet, and mobile
  • πŸ”’ Secure & Private - Your data stays in your browser
  • ⚑ Lightning Fast - Built with modern web technologies
  • 🎯 Accessibility First - Designed for users of all abilities

🎬 Demo

Try these voice commands:

  • "Create task: Design new homepage"
  • "Show me all projects"
  • "Mark task complete"
  • "New project: Mobile App Development"

πŸ› οΈ Tech Stack

  • Frontend: React 18 with TypeScript
  • Styling: Tailwind CSS with custom Neo-Brutalism design
  • Build Tool: Vite
  • Voice Recognition: Web Speech API
  • Speech Synthesis: Web Speech Synthesis API
  • Icons: Lucide React
  • Storage: LocalStorage (client-side)

πŸš€ Quick Start

Prerequisites

  • Node.js 18+
  • npm or yarn

Installation

  1. Clone the repository

    git clone https://github.com/mobeen-asghar/VoiceProj.git
    cd VoiceProj
  2. Install dependencies

    npm install
  3. Start the development server

    npm run dev
  4. Open your browser Navigate to http://localhost:5173

  5. Enable microphone permissions Allow microphone access when prompted to use voice features

πŸ“– Usage Guide

Getting Started

  1. Sign Up: Create your account on the landing page
  2. Create a Project: Click "NEW PROJECT" or say "Create project [name]"
  3. Add Tasks: Use "NEW TASK" button or voice command "Create task [description]"
  4. Voice Control: Click the microphone icon and start speaking!

Voice Commands

Command Action
"Create task [name]" Creates a new task
"New project [name]" Creates a new project
"Show projects" Lists all projects
"Mark task complete" Completes the first pending task
"Open settings" Opens the settings page
"Search [query]" Opens search with query

Project Structure

src/
β”œβ”€β”€ components/          # React components
β”‚   β”œβ”€β”€ LandingPage.tsx     # Marketing landing page
β”‚   β”œβ”€β”€ VoiceInterface.tsx  # Voice recognition UI
β”‚   β”œβ”€β”€ TaskCard.tsx        # Individual task display
β”‚   β”œβ”€β”€ ProjectCard.tsx     # Project display component
β”‚   β”œβ”€β”€ Dashboard.tsx       # Main dashboard
β”‚   β”œβ”€β”€ Header.tsx          # Navigation header
β”‚   β”œβ”€β”€ SettingsPage.tsx    # User settings
β”‚   └── ...
β”œβ”€β”€ contexts/           # React contexts
β”‚   └── AuthContext.tsx    # Authentication state
β”œβ”€β”€ hooks/              # Custom React hooks
β”‚   β”œβ”€β”€ useVoiceRecognition.ts
β”‚   └── useSpeechSynthesis.ts
β”œβ”€β”€ services/           # Business logic
β”‚   β”œβ”€β”€ authService.ts     # Authentication
β”‚   └── dataService.ts     # Data management
β”œβ”€β”€ types/              # TypeScript definitions
└── styles/             # CSS and styling

🎨 Design Philosophy

VoiceProj embraces Neo-Brutalism design principles:

  • Bold Typography: Heavy, impactful fonts that demand attention
  • High Contrast: Black borders and vibrant colors for maximum accessibility
  • Geometric Shapes: Clean lines and sharp edges
  • Playful Interactions: Hover effects and micro-animations
  • Accessibility First: High contrast ratios and keyboard navigation

🌐 Browser Support

VoiceProj works best in modern browsers with Web Speech API support:

  • βœ… Chrome 25+
  • βœ… Edge 79+
  • βœ… Safari 14.1+
  • βœ… Firefox 49+ (limited support)

πŸ”§ Configuration

Environment Variables

Create a .env file in the root directory:

VITE_APP_NAME=VoiceProj
VITE_APP_VERSION=1.0.0

Voice Settings

Customize voice recognition in src/hooks/useVoiceRecognition.ts:

recognition.lang = 'en-US'; // Change language
recognition.continuous = true; // Continuous listening
recognition.interimResults = true; // Show interim results

🀝 Contributing

We welcome contributions! Here's how to get started:

  1. Fork the repository
  2. Create a feature branch
    git checkout -b feature/amazing-feature
  3. Make your changes
  4. Add tests (if applicable)
  5. Commit your changes
    git commit -m 'Add amazing feature'
  6. Push to the branch
    git push origin feature/amazing-feature
  7. Open a Pull Request

Development Guidelines

  • Follow the existing code style
  • Write meaningful commit messages
  • Add JSDoc comments for new functions
  • Test voice commands thoroughly
  • Ensure accessibility compliance

πŸ“ Scripts

Command Description
npm run dev Start development server
npm run build Build for production
npm run preview Preview production build
npm run lint Run ESLint

πŸ› Known Issues

  • Voice recognition may not work in noisy environments
  • Some browsers require HTTPS for microphone access
  • Speech synthesis voices vary by operating system

πŸ—ΊοΈ Roadmap

  • Real-time Collaboration - Live project sharing
  • Mobile App - Native iOS and Android apps
  • AI Assistant - Smart task suggestions
  • Integrations - Slack, Trello, GitHub connections
  • Advanced Analytics - Project insights and reporting
  • Offline Mode - Work without internet connection

πŸ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

πŸ™ Acknowledgments

  • Web Speech API - For making voice recognition possible
  • Tailwind CSS - For the utility-first CSS framework
  • Lucide React - For the beautiful icons
  • Pexels - For the stock photography

πŸ“ž Support

Having issues? We're here to help!

🌟 Show Your Support

If you find VoiceProj helpful, please consider:

  • ⭐ Starring this repository
  • 🐦 Sharing on social media
  • 🀝 Contributing to the project
  • πŸ’ Sponsoring development

Made with ❀️ and 🎀 by the VoiceProj Team



Ready to speak your projects into existence?

Get Started

About

A project management tool that uses voice commands to manage tasks, set reminders, and collaborate, integrated with voice assistants.

Topics

Resources

License

Stars

Watchers

Forks

Contributors

Languages