{"id":21271849,"url":"https://github.com/nhnaahid/alterwhite-client","last_synced_at":"2026-04-07T07:03:25.905Z","repository":{"id":247090038,"uuid":"818751184","full_name":"nhnaahid/alterwhite-client","owner":"nhnaahid","description":"AlterWhite is an Alternative Product Information System web application designed to enhance user experience by providing a comprehensive platform for managing and exploring product-related queries.","archived":false,"fork":false,"pushed_at":"2024-07-06T13:54:56.000Z","size":10202,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-01-03T12:03:48.667Z","etag":null,"topics":["css3","expressjs","firebase","html5","jwt","mongodb","nodejs","reactjs","tailwindcss"],"latest_commit_sha":null,"homepage":"https://alterwhite-507f4.web.app/","language":"JavaScript","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/nhnaahid.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}},"created_at":"2024-06-22T18:53:53.000Z","updated_at":"2024-07-06T13:55:00.000Z","dependencies_parsed_at":null,"dependency_job_id":"2a58fa32-65e8-410a-91ee-16f5ba912b19","html_url":"https://github.com/nhnaahid/alterwhite-client","commit_stats":null,"previous_names":["nhnaahid/alterwhite-client"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/nhnaahid/alterwhite-client","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nhnaahid%2Falterwhite-client","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nhnaahid%2Falterwhite-client/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nhnaahid%2Falterwhite-client/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nhnaahid%2Falterwhite-client/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nhnaahid","download_url":"https://codeload.github.com/nhnaahid/alterwhite-client/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nhnaahid%2Falterwhite-client/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31503394,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-07T03:10:19.677Z","status":"ssl_error","status_checked_at":"2026-04-07T03:10:13.982Z","response_time":105,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["css3","expressjs","firebase","html5","jwt","mongodb","nodejs","reactjs","tailwindcss"],"created_at":"2024-11-21T08:28:33.780Z","updated_at":"2026-04-07T07:03:25.884Z","avatar_url":"https://github.com/nhnaahid.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# AlterWhite\n\nAlterWhite is an Alternative Product Information System web application designed to enhance user experience by providing a comprehensive platform for managing and exploring product-related queries. With a focus on responsiveness and user-friendliness, security, and efficiency, AlterWhite allows users to create account, browse and search for product queries, and manage recommendations.\n \n\n\n## Demo\n\n- [Live Link](https://alterwhite-507f4.web.app/)\n- [Server Side Repo](https://github.com/nhnaahid/alterwhite-server)\n- user email: nahid@gmail.com\n- user pass: Nahid@123\n\n# Getting Started\n\nThese instructions will help you get a copy of the project up and running on your local machine for development and testing purposes.\n\n## Prerequisites\n\nMake sure you have the following installed:\n- [Git](https://git-scm.com/)\n- [Node.js](https://nodejs.org/)\n- [MongoDB](https://www.mongodb.com/try/download/community)\n- [Firebase CLI](https://firebase.google.com/docs/cli)\n\n## Installation\n\n1. **Clone \u0026 Install client dependencies:**\n\n    ```bash\n    git clone https://github.com/nhnaahid/alterwhite-client.git\n    cd your-client-repository\n    npm install\n    ```\n\n2. **Clone \u0026 Install server dependencies:**\n\n    ```bash\n    git clone https://github.com/nhnaahid/alterwhite-server.git\n    cd your-server-repository\n    npm install\n    ```\n\n4. **Set up environment variables:**\n\n    Create a `.env.local` file in the `client` directory and add the following:\n\n    ```env\n    VITE_apiKey=your_firebase_api_key\n    VITE_authDomain=your_firebase_auth_domain\n    VITE_projectId=your_firebase_project_id\n    VITE_storageBucket=your_firebase_storage_bucket\n    VITE_messagingSenderId=your_firebase_messaging_sender_id\n    VITE_appId=your_firebase_app_id\n    ```\n\n    Create a `.env` file in the `server` directory and add the following:\n\n    ```env\n    DB_USER=mongodb_uri_user\n    DB_PASS=mongodb_uri_pass\n    ACCESS_TOKEN_SECRET=generated_jwt_token\n    ```\n\n5. **Run the server:**\n\n    ```bash\n    cd your-server-repository\n    nodemon index.js\n    ```\n\n6. **Run the client:**\n\n    Open a new terminal window/tab and run:\n\n    ```bash\n    cd your-client-repository\n    npm run dev\n    ```\n\n## Firebase \u0026 JWT Setup\nPlease follow their docs to integrate firebase authentication, create and store jwt in local storage for authorization.\n\n## Usage\n\nOnce the server and client are running, open your web browser and go to `http://localhost:5173` to view the application.\n\n\n## Key Features\n\n- **User Profile Management:** Users can create Account.\n- **Firebase Authentication:** Secure and reliable authentication using Firebase.\n- **Query Management:** Users can browse, add, update, and delete product queries.\n- **Search Functionality:** Efficient search mechanism to find queries by product name.\n- **Recommendations:** Users can view, add, update and delete recommendations.\n- **Responsive Design:** Optimized for various devices (Mobile, Tablet, Laptop etc.) to ensure a seamless experience.\n- **Personalized Recommendations:** Users can view recommended products based on their added queries and recommendations.\n- **JSON Web Token (JWT) Security:** Ensures secure data transmission, authentication and authorization.\n\n\n## Tech Stack\n\nAlterWhite is built using the MERN stack, a powerful combination of technologies that provide a seamless development experience for both the frontend and backend.\n\n- **Frontend:** React.js, Tailwind.css\n- **Backend:** Node.js, Express.js\n- **Database:** MongoDB\n- **Authentication:** Firebase Authentication\n- **Security:** JSON Web Tokens (JWT)\n- **Hosting:** Firebase, vercel\n- **Version Control:** Git, GitHub\n\nBy utilizing the MERN stack and these additional tools, AlterWhite ensures a robust, scalable, and high-performance web application that delivers a seamless user experience to all.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnhnaahid%2Falterwhite-client","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnhnaahid%2Falterwhite-client","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnhnaahid%2Falterwhite-client/lists"}