A powerful, intuitive web application for security researchers, penetration testers, and cybersecurity professionals to craft advanced Google search queries (Google Dorks) with ease.
- Visual Query Builder: Drag-and-drop interface for building complex Google Dork queries
- 50+ Operators: Comprehensive collection of Google search operators including advanced and lesser-known ones
- Multi-Input Support: Specialized handling for operators requiring multiple inputs (OR, AROUND, etc.)
- Real-time Preview: Live query generation as you build your search
- Query Management: Add, remove, and reorder query components with drag-and-drop
- 30+ Common Dorks: Ready-to-use queries for common security research tasks
- Risk Assessment: Each dork includes risk level indicators and use case descriptions
- Expandable Details: View multiple dork explanations simultaneously
- One-click Loading: Instantly load pre-built queries into the builder
- Responsive Design: Optimized for desktop, tablet, and mobile devices
- Dark Theme: Professional dark interface with excellent contrast
- Auto-focus: Streamlined workflow with intelligent input focusing
- Export Options: Copy, search directly, or export queries as JSON
- Category Filtering: Organize operators by type (Site, Content, File, etc.)
- Next.js 13 - React framework with App Router
- TypeScript - Type-safe development
- Tailwind CSS - Utility-first styling
- Framer Motion - Smooth animations and transitions
- Radix UI - Accessible component primitives
- Zustand - Lightweight state management
- React Hooks - Local component state
- @dnd-kit - Drag and drop functionality
- Lucide React - Beautiful icon library
- Sonner - Toast notifications
- shadcn/ui - Modern component library
- ESLint - Code linting
- PostCSS - CSS processing
- Autoprefixer - CSS vendor prefixes
components/
├── dork-builder.tsx # Main builder interface
├── operator-selector.tsx # Operator selection and input
├── active-queries.tsx # Drag-and-drop query list
├── common-dorks.tsx # Pre-built dork library
├── query-output.tsx # Final query display
├── category-pills.tsx # Operator category filters
└── file-type-selector.tsx # Quick file type selection
stores/
├── dork-store.ts # Query building state
└── ui-store.ts # UI interaction state
lib/
├── google-dorks.ts # Operator definitions and common dorks
└── utils.ts # Utility functions
- Operator Categories: Organized into Basic, Site, Content, File, Meta, and Advanced categories
- Smart Input Handling: Different input types for different operators (single, dual, file types)
- Query Validation: Real-time validation and error handling
- Syntax Highlighting: Color-coded query display
- Reorderable Queries: Change query order with smooth drag-and-drop
- Visual Feedback: Clear drag indicators and hover states
- Keyboard Accessible: Full keyboard navigation support
- Touch Friendly: Optimized for mobile touch interactions
- Loading States: Smooth transitions and loading indicators
- Error Handling: Graceful error messages and recovery
- Responsive Layout: Adaptive design for all screen sizes
- Accessibility: WCAG compliant with proper ARIA labels
# Clone the repository
git clone https://github.com/yourusername/dorkcraft.git
# Navigate to project directory
cd dorkcraft
# Install dependencies
npm install
# Start development server
npm run dev
# Build for production
npm run build
# Start production server
npm startThe application is fully responsive with breakpoints optimized for:
- Mobile: 320px - 768px (Stacked layout, touch-optimized)
- Tablet: 768px - 1024px (Hybrid layout)
- Desktop: 1024px+ (Full horizontal layout)
- Educational Purpose: Designed for legitimate security research and testing
- Terms of Service: Clear guidelines for responsible use
- Privacy Policy: Transparent data handling practices
- No Data Storage: Queries are not stored or transmitted to external servers
- Client-side Processing: All query building happens in the browser
- No API Keys: No external API dependencies
- Secure Defaults: Safe configuration out of the box
- Primary: Blue (#3B82F6) - Actions and highlights
- Secondary: Emerald (#10B981) - Success states
- Accent: Orange (#F97316) - Warnings and emphasis
- Neutral: Slate (#64748B) - Text and backgrounds
- Danger: Red (#EF4444) - Errors and destructive actions
- Headings: Inter font family, various weights
- Body: Inter font family, regular weight
- Code: Monospace font family for query display
- Code Splitting: Automatic route-based code splitting with Next.js
- Image Optimization: Next.js Image component for optimized loading
- Bundle Analysis: Webpack bundle analyzer for size optimization
- Lazy Loading: Components loaded on demand
- Memoization: React.memo and useMemo for expensive operations
The application is configured for static export and can be deployed to:
- Vercel (Recommended for Next.js)
- Netlify
- GitHub Pages
- Any static hosting service
# Build and export static files
npm run build
# Files will be generated in the 'out' directoryThis project follows standard contribution guidelines:
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
- Google - For providing the search operators that make this tool possible
- Security Community - For documenting and sharing Google Dork techniques
- Open Source Libraries - All the amazing libraries that made this project possible
Your Name - Shariatian92@gmail.com
Project Link: https://github.com/AliShariatian/DorkCraft
⭐ Star this repository if you found it helpful!