{"id":28904801,"url":"https://github.com/adityagupta62005/soleselect","last_synced_at":"2026-04-28T16:02:55.846Z","repository":{"id":298119153,"uuid":"998920871","full_name":"AdityaGupta62005/SoleSelect","owner":"AdityaGupta62005","description":"A modern shoe booking platform built with Next.js, TypeScript, and Tailwind CSS.","archived":false,"fork":false,"pushed_at":"2025-06-17T13:35:45.000Z","size":13903,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-17T14:27:31.811Z","etag":null,"topics":["ecommerce","nextjs","react","shoes","typescript","vercel"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AdityaGupta62005.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-09T13:14:30.000Z","updated_at":"2025-06-17T13:35:49.000Z","dependencies_parsed_at":"2025-06-09T14:47:17.810Z","dependency_job_id":null,"html_url":"https://github.com/AdityaGupta62005/SoleSelect","commit_stats":null,"previous_names":["adityagupta62005/soleselect"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/AdityaGupta62005/SoleSelect","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AdityaGupta62005%2FSoleSelect","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AdityaGupta62005%2FSoleSelect/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AdityaGupta62005%2FSoleSelect/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AdityaGupta62005%2FSoleSelect/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AdityaGupta62005","download_url":"https://codeload.github.com/AdityaGupta62005/SoleSelect/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AdityaGupta62005%2FSoleSelect/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261126447,"owners_count":23113312,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ecommerce","nextjs","react","shoes","typescript","vercel"],"created_at":"2025-06-21T13:02:25.178Z","updated_at":"2026-04-28T16:02:55.840Z","avatar_url":"https://github.com/AdityaGupta62005.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SoleSelect - Shoe Booking Platform\n\nA modern, full-featured e-commerce platform for browsing, filtering, and purchasing shoes. Built with Next.js, React, TypeScript, and Tailwind CSS.\n\n## 🚀 Features\n\n### 🔐 Authentication System\n- **User Registration \u0026 Login**: Secure authentication with role-based access\n- **Protected Routes**: Authentication required for all main features\n- **Admin Dashboard**: Separate admin interface with elevated permissions\n- **Session Management**: Persistent login state across browser sessions\n\n### 🛒 Shopping Experience\n- **Product Catalog**: Browse extensive shoe collection with detailed information\n- **Advanced Filtering**: Filter by brand, size, color, and price range\n- **Search Functionality**: Find shoes quickly with intelligent search\n- **Shopping Cart**: Add, remove, and modify cart items with size/color selection\n- **Wishlist**: Save favorite items for later (coming soon)\n\n### 💳 Checkout \u0026 Orders\n- **Secure Checkout**: Complete order process with shipping and payment details\n- **Order Management**: Track order status and history\n- **Order Confirmation**: Detailed confirmation with order tracking\n- **Multiple Payment Options**: Credit card processing (mock implementation)\n\n### 👤 User Management\n- **User Profiles**: Comprehensive profile management with personal information\n- **Order History**: View all past orders with detailed breakdowns\n- **Security Settings**: Change passwords and manage account security\n- **Notification Preferences**: Customize email and SMS notifications\n\n### 🔧 Admin Features\n- **Dashboard Analytics**: Revenue, orders, products, and user statistics\n- **Inventory Management**: Add, edit, and remove products\n- **Order Processing**: Monitor and update order statuses\n- **User Administration**: Manage user accounts and permissions\n\n## 🛠️ Tech Stack\n\n- **Frontend**: Next.js 14, React 18, TypeScript\n- **Styling**: Tailwind CSS, shadcn/ui components\n- **State Management**: React Context API\n- **Icons**: Lucide React\n- **Storage**: localStorage (development), ready for database integration\n- **Authentication**: Custom implementation (ready for JWT/OAuth)\n\n## 📦 Installation\n\n1. **Clone the repository**\n   ```bash\n   git clone https://github.com/yourusername/soleselect.git\n   cd soleselect\n   ```\n\n2. **Install dependencies**\n   ```bash\n   npm install\n   # or\n   yarn install\n   # or\n   pnpm install\n   ```\n\n3. **Run the development server**\n   ```bash\n   npm run dev\n   # or\n   yarn dev\n   # or\n   pnpm dev\n   ```\n\n4. **Open your browser**\n   Navigate to [http://localhost:3000](http://localhost:3000)\n\n## 🔑 Demo Credentials\n\n### Admin Access\n- **Email**: admin@gmail.com\n- **Password**: admin123\n\n### User Registration\n- Register with any valid email and password\n- All new registrations default to user role\n\n## 📁 Screenshots\n\n![Screenshot 2025-06-09 181630](https://github.com/user-attachments/assets/2f3023e7-cd9c-424b-aef2-66e88dd2d9ae)\n![Screenshot 2025-06-09 181700](https://github.com/user-attachments/assets/152cf321-0cb0-40ec-b8ce-662be02d6bc5)\n![Screenshot 2025-06-09 181732](https://github.com/user-attachments/assets/c8f38811-4741-4513-82ea-02ced8e45a24)\n![Screenshot 2025-06-09 181751](https://github.com/user-attachments/assets/c6f5a210-c7b6-4f45-95ed-5f46b5a4d549)\n![Screenshot 2025-06-09 182021](https://github.com/user-attachments/assets/ae93e3c7-62d5-4678-b2a0-94a9da0350d8)\n![Screenshot 2025-06-09 182504](https://github.com/user-attachments/assets/9524747e-02f4-464a-bf29-ddfda5bd8102)\n![Screenshot 2025-06-09 182639](https://github.com/user-attachments/assets/7f5cbbb8-2beb-4486-aac5-a18d7e519d05)\n![Screenshot 2025-06-09 182716](https://github.com/user-attachments/assets/503170e3-85a2-4c0d-9c53-681d27bc86ce)\n\n\n## 🎯 Key Components\n\n### Authentication Context\nManages user authentication state, login/logout functionality, and role-based access control.\n\n### Cart Context\nHandles shopping cart operations including adding items, updating quantities, and calculating totals.\n\n### Protected Routes\nEnsures authentication is required for accessing main application features.\n\n### Admin Dashboard\nComprehensive admin interface with analytics, inventory management, and order processing.\n\n## 🔄 State Management\n\nThe application uses React Context API for global state management:\n\n- **AuthContext**: User authentication and session management\n- **CartContext**: Shopping cart state and operations\n- **localStorage**: Persistent data storage for cart and orders\n\n## 🎨 UI/UX Features\n\n- **Responsive Design**: Mobile-first approach with adaptive layouts\n- **Dark Mode Support**: Built-in theme switching capability\n- **Loading States**: Skeleton loaders and loading indicators\n- **Error Handling**: Graceful error states and user feedback\n- **Accessibility**: ARIA labels and keyboard navigation support\n\n## 🚀 Deployment\n\n### Vercel (Recommended)\n1. Push your code to GitHub\n2. Connect your repository to Vercel\n3. Deploy with zero configuration\n\n### Other Platforms\nThe application can be deployed to any platform that supports Next.js:\n- Netlify\n- AWS Amplify\n- Railway\n- DigitalOcean App Platform\n\n## 🔮 Future Enhancements\n\n### Planned Features\n- [ ] Real-time notifications\n- [ ] Product reviews and ratings\n- [ ] Wishlist functionality\n- [ ] Advanced search with AI\n- [ ] Inventory tracking\n- [ ] Multiple payment gateways\n- [ ] Social authentication\n- [ ] Email notifications\n- [ ] Mobile app (React Native)\n\n### Backend Integration\n- [ ] Database integration (PostgreSQL/MongoDB)\n- [ ] RESTful API development\n- [ ] JWT authentication\n- [ ] File upload for product images\n- [ ] Payment processing (Stripe/PayPal)\n- [ ] Email service integration\n- [ ] Analytics and reporting\n\n## 🤝 Contributing\n\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n## 📝 Development Guidelines\n\n### Code Style\n- Use TypeScript for type safety\n- Follow ESLint and Prettier configurations\n- Use meaningful component and variable names\n- Write self-documenting code with comments where necessary\n\n### Component Structure\n- Keep components small and focused\n- Use custom hooks for complex logic\n- Implement proper error boundaries\n- Follow React best practices\n\n### Testing (Coming Soon)\n- Unit tests with Jest and React Testing Library\n- Integration tests for user flows\n- E2E tests with Playwright\n\n## 🐛 Known Issues\n\n- Mock data is used for demonstration purposes\n- Payment processing is simulated\n- Email notifications are not implemented\n- Real-time features require backend integration\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 📞 Support\n\nFor support, email support@soleselect.com or create an issue in the GitHub repository.\n\n---\n\n**SoleSelect** - Step Into Style 👟\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadityagupta62005%2Fsoleselect","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fadityagupta62005%2Fsoleselect","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadityagupta62005%2Fsoleselect/lists"}