{"id":24532692,"url":"https://github.com/follownaim/career-compass","last_synced_at":"2026-04-29T21:04:02.008Z","repository":{"id":265063381,"uuid":"890006957","full_name":"FollowNaim/Career-Compass","owner":"FollowNaim","description":"Career Compass - Career Counseling Website - A responsive platform built with React, Firebase, shadcnUI, and Framer motion, offering personalized career guidance and seamless user experience.","archived":false,"fork":false,"pushed_at":"2025-01-08T08:05:37.000Z","size":1894,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-08T15:36:19.815Z","etag":null,"topics":["firebase","framer-motion","react","shadcn-ui"],"latest_commit_sha":null,"homepage":"https://ccompass.vercel.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/FollowNaim.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-11-17T19:26:58.000Z","updated_at":"2025-01-08T08:05:41.000Z","dependencies_parsed_at":"2025-03-15T21:16:35.110Z","dependency_job_id":"d1cda188-5704-45bc-8f96-75c0406d876a","html_url":"https://github.com/FollowNaim/Career-Compass","commit_stats":null,"previous_names":["follownaim/career-compass","ar-naim/career-compass"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/FollowNaim/Career-Compass","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FollowNaim%2FCareer-Compass","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FollowNaim%2FCareer-Compass/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FollowNaim%2FCareer-Compass/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FollowNaim%2FCareer-Compass/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/FollowNaim","download_url":"https://codeload.github.com/FollowNaim/Career-Compass/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FollowNaim%2FCareer-Compass/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32443576,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-29T20:22:27.477Z","status":"ssl_error","status_checked_at":"2026-04-29T20:22:26.507Z","response_time":110,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6: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":["firebase","framer-motion","react","shadcn-ui"],"created_at":"2025-01-22T10:18:03.894Z","updated_at":"2026-04-29T21:04:01.992Z","avatar_url":"https://github.com/FollowNaim.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Career Compass 🫂\n\nAn interactive and responsive **Career Counseling Website** designed to guide users toward informed career decisions. Built with modern technologies like **React**, **React Router**, and **Firebase**, this platform offers seamless navigation, personalized advice, and dynamic services tailored to professional growth.\n\n---\n\n## 🌐 [Live Site](https://ccompass.vercel.app/)\n\n---\n\n## Showcase\n\n\u003cimg src='https://i.ibb.co.com/1vDsfM0/01.jpg'/\u003e\n\n---\n\n## 🛠️ Technologies Used\n\n- **React**: For a dynamic and robust user interface.\n- **React Router**: For efficient routing and navigation.\n- **Firebase**: Handles authentication, data management, and profile updates.\n- **Swiper Slider**: For a visually appealing slider on the home page.\n- **Framer Motion**: Adds smooth scrolling animations to enhance user engagement.\n- **ShadCN UI**: To design and style reusable components.\n- **TailwindCSS**: For responsive and modern UI styling.\n\n---\n\n## ✨ Features\n\n- **Dynamic Career Services**\n\n  - Displayed using JSON data with cards for services like Career Counseling, Resume Reviews, and more.\n  - Each service showcases details like category, pricing, duration, counselor, and ratings.\n\n- **User Authentication**\n\n  - Email and password-based registration with password validation (uppercase, lowercase, and length).\n  - Google login integration for quick access.\n  - Functional forgot password flow with email input and reset functionality.\n\n- **Responsive Design**\n\n  - Fully optimized for mobile, tablet, and desktop devices.\n  - Includes a hamburger menu for smooth navigation on smaller screens.\n\n- **User Profile Management**\n\n  - Protected \"My Profile\" page displaying user information (name, email, photo).\n  - Editable user details using Firebase's `updateProfile()` method.\n\n- **Engaging Animations**\n  - Smooth scrolling animations powered by Framer Motion.\n  - A visually stunning Swiper slider to highlight key sections on the home page.\n\n---\n\n## 🌟 Highlights\n\n- **Dynamic Title System**: Each page dynamically updates its title for better UX and SEO.\n- **Protected Routes**: Ensures private pages like \"Service Details\" and \"My Profile\" are secure.\n- **Persistent Login State**: Logged-in users stay authenticated even after page reloads.\n- **404 Page**: Custom-designed \"Not Found\" page for invalid routes.\n- **Service Feedback**: Users can leave comments or feedback on individual services.\n\n---\n\n## Dependencies\n\n- **@radix-ui/react-avatar**: ^1.1.1 – A Radix UI component for displaying user avatars.\n- **@radix-ui/react-dialog**: ^1.1.2 – A Radix UI component for creating dialog modals.\n- **@radix-ui/react-label**: ^2.1.0 – A Radix UI label component for forms.\n- **@radix-ui/react-popover**: ^1.1.2 – A Radix UI component for creating popovers.\n- **@radix-ui/react-scroll-area**: ^1.2.1 – A Radix UI component for scrollable areas.\n- **@radix-ui/react-select**: ^2.1.2 – A Radix UI select dropdown component.\n- **@radix-ui/react-slot**: ^1.1.0 – A utility for passing dynamic components as slots.\n- **@radix-ui/react-toast**: ^1.2.2 – A Radix UI component for creating toast notifications.\n- **@tabler/icons-react**: ^3.22.0 – A library of Tabler icons for React.\n- **class-variance-authority**: ^0.7.0 – Utility for handling className variants in React.\n- **clsx**: ^2.1.1 – Utility for constructing `className` strings conditionally.\n- **cmdk**: ^1.0.0 – Command menu component for React.\n- **date-fns**: ^3.6.0 – Utility library for working with JavaScript dates.\n- **firebase**: ^11.0.2 – Google Firebase JavaScript SDK.\n- **framer-motion**: ^11.11.17 – Motion library for React animations.\n- **hamburger-react**: ^2.5.1 – A hamburger menu button component.\n- **lucide-react**: ^0.460.0 – React icons library with beautiful, consistent icons.\n- **react**: ^18.3.1 – A JavaScript library for building user interfaces.\n- **react-day-picker**: ^8.10.1 – A date picker component for React.\n- **react-dom**: ^18.3.1 – React package for working with the DOM.\n- **react-dropzone**: ^14.3.5 – A React component for handling file uploads via drag and drop.\n- **react-helmet-async**: ^2.0.5 – A library for managing document head tags asynchronously.\n- **react-hot-toast**: ^2.4.1 – Toast notification library for React.\n- **react-icons**: ^5.3.0 – Popular icon library for React.\n- **react-lottie**: ^1.2.7 – A React library for rendering Lottie animations.\n- **react-phone-number-input**: ^3.4.9 – A React component for inputting phone numbers.\n- **react-router-dom**: ^6.28.0 – Declarative routing for React applications.\n- **swiper**: ^11.1.14 – A modern mobile touch slider library.\n- **tailwind-merge**: ^2.5.4 – Utility for merging Tailwind CSS class strings.\n- **tailwindcss-animate**: ^1.0.7 – Animation utilities for Tailwind CSS.\n\n---\n\n## Dev Dependencies\n\n- **@eslint/js**: ^9.13.0 – ESLint's core JavaScript functionality.\n- **@types/react**: ^18.3.12 – TypeScript definitions for React.\n- **@types/react-dom**: ^18.3.1 – TypeScript definitions for React DOM.\n- **@vitejs/plugin-react**: ^4.3.3 – Vite plugin for React support.\n- **autoprefixer**: ^10.4.20 – PostCSS plugin for adding vendor prefixes automatically.\n- **eslint**: ^9.13.0 – A tool for identifying and fixing JavaScript code issues.\n- **eslint-plugin-react**: ^7.37.2 – ESLint plugin for React best practices.\n- **eslint-plugin-react-hooks**: ^5.0.0 – ESLint rules for React hooks.\n- **eslint-plugin-react-refresh**: ^0.4.14 – ESLint plugin for React Fast Refresh.\n- **globals**: ^15.11.0 – Global variable definitions for ESLint.\n- **postcss**: ^8.4.49 – A tool for transforming CSS with JavaScript plugins.\n- **tailwindcss**: ^3.4.15 – A utility-first CSS framework.\n- **vite**: ^5.4.10 – Next-generation frontend build tool.\n\n---\n\n## 🔧 How to Run Locally\n\n1. **Clone the Repository**\n\n```bash\n   git clone https://github.com/follownaim/career-compass.git\n   cd career-compass\n```\n\n2. **Install Dependencies**\n\n```bash\nnpm install\n```\n\n3. **Set Up Environment Variables**\n   - Create a .env.local file in the root directory.\n   - Add Firebase configuration keys on env.local\n\n```bash\nVITE_Projectid\nVITE_apikey\n```\n\nlike this.\n\n4. **Run the application**\n\n```bash\nnpm run dev\n```\n\n5. **Access the App**\n   - Open http://localhost:5173 in your browser.\n\n---\n\n## 🛠️ Deployment\n\n- Hosted on Netlify or Vercel for a fast and reliable experience.\n- Firebase Authentication requires authorized domains to ensure secure access.\n\n---\n\n## 📝 Future Enhancements\n\n- Add career analytics and trend visualization.\n- Integrate external resources like job boards and mentorship programs.\n- Advanced search and filtering for career services.\n\n---\n\n## 🤝 Contributions\n\nContributions are welcome! Fork this repository, make your changes, and submit a pull request.\n\n---\n\n_Career Compass – Empowering Your Professional Journey._\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffollownaim%2Fcareer-compass","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffollownaim%2Fcareer-compass","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffollownaim%2Fcareer-compass/lists"}