Skip to content

youse7abib/dashboard

Repository files navigation

Dashboard Management System

A comprehensive web-based dashboard application for managing products, clients, and posts with a modern, responsive design.

🚀 Features

Core Modules

  • Product Management: Full CRUD operations for product inventory
  • Client Management: Customer data management with contact information
  • Post Management: Content management system with API integration
  • User Authentication: Secure login system
  • Theme Support: Dark/Light mode toggle
  • Responsive Design: Mobile-friendly interface

Key Functionalities

  • Local Storage: Persistent data storage using browser localStorage
  • Search & Filter: Advanced search capabilities across all modules
  • Keyboard Shortcuts: Enhanced productivity with hotkeys
  • Form Validation: Input validation and error handling
  • Interactive UI: Hover effects and smooth transitions

🛠️ Technologies Used

  • Frontend: HTML5, CSS3, JavaScript (ES6+)
  • Storage: Browser localStorage API
  • APIs: JSONPlaceholder for sample posts
  • Icons: Font Awesome 6.4.0
  • Images: Picsum for placeholder images
  • Forms: Formspree for contact form handling

⚡ Quick Start

  1. Clone or download the project files
  2. Open login.html in your web browser
  3. Login with credentials:
    • Username: admin
    • Password: admin
  4. Navigate through the dashboard modules

🎯 Module Details

Product Management

  • Add, edit, delete products
  • Calculate totals with taxes, ads, and discounts
  • Bulk operations (create multiple items)
  • Search by title or category
  • Data validation and error handling

Client Management

  • Store customer contact information
  • Search by name or email
  • Update and delete client records
  • Export-friendly data structure

Post Management

  • Fetch posts from JSONPlaceholder API
  • Create and manage custom posts
  • Image integration with Picsum
  • Read-only API posts vs editable user posts

Authentication

  • Simple admin authentication
  • Session persistence
  • Automatic redirects for unauthorized access

⌨️ Keyboard Shortcuts

Shortcut Action
Ctrl + N Create new item
Ctrl + S Save current item
Ctrl + F Focus search field
Delete Delete all items (with confirmation)
Escape Clear form and cancel operations

🎨 Themes

The application supports both dark and light themes:

  • Dark Theme: Default professional dark interface
  • Light Theme: Clean light interface for better readability
  • Theme preference is saved in localStorage

📱 Responsive Design

  • Mobile-first approach
  • Flexible layouts that adapt to screen sizes
  • Touch-friendly interface elements
  • Optimized for tablets and desktop

🔧 Customization

Adding New Modules

  1. Create new HTML file following the dashboard template
  2. Add navigation link in the sidebar
  3. Implement corresponding JavaScript logic
  4. Update CSS for styling consistency

Modifying Styles

  • Edit dashboard.css for global dashboard styles
  • Modify style.css for form and component styles
  • Update CSS custom properties for theme colors

Data Structure

All data is stored in localStorage with the following keys:

  • product: Product inventory data
  • client: Customer information
  • userPosts: User-created posts
  • theme: Theme preference
  • auth: Authentication status

🚨 Important Notes

  • Local Storage Dependency: All data is stored locally in the browser
  • No Backend: This is a client-side only application
  • Demo Credentials: Use admin/admin for login
  • API Integration: Posts module uses JSONPlaceholder for demo data

🤝 Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Test across different browsers
  5. Submit a pull request

📄 License

This project is open source and available under the MIT License.

👨‍💻 Author

Yousef Reda Habib

🔮 Future Enhancements

  • Backend integration with REST API
  • Advanced user roles and permissions
  • Data export/import functionality
  • Advanced analytics and reporting
  • Real-time notifications
  • Multi-language support
  • Advanced search and filtering options

Built with ❤️ for efficient business management

Releases

Packages

Contributors

Languages