{"id":18055668,"url":"https://github.com/chanmeng666/friendscope","last_synced_at":"2025-06-22T18:08:48.342Z","repository":{"id":260218859,"uuid":"880644604","full_name":"ChanMeng666/friendscope","owner":"ChanMeng666","description":"【Be the reason someone's repo counter goes up today! ⭐️】A modern web application for evaluating and strengthening friendships through scientific assessment and personalized insights. Built with Next.js and TypeScript, offering sophisticated visualizations, privacy-focused design, and evidence-based recommendations.","archived":false,"fork":false,"pushed_at":"2025-01-15T04:10:53.000Z","size":542,"stargazers_count":5,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-06-22T18:08:40.546Z","etag":null,"topics":["assessment","data-visualization","framer-motion","friendship","friendship-assessment","lottie-animations","nextjs","privacy-focused","psychology","react","recharts","relationship-analysis","responsive-design","scientific-assessment","shadcn","shadcn-ui","tailwindcss","typescript","zustand"],"latest_commit_sha":null,"homepage":"https://friendscope.vercel.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ChanMeng666.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":null,"buy_me_a_coffee":"chanmeng66u","thanks_dev":null,"custom":null}},"created_at":"2024-10-30T04:48:07.000Z","updated_at":"2025-05-11T14:36:01.000Z","dependencies_parsed_at":"2024-11-17T06:21:47.301Z","dependency_job_id":"40272dee-9f90-4408-b600-0cc84d29b373","html_url":"https://github.com/ChanMeng666/friendscope","commit_stats":null,"previous_names":["chanmeng666/friendscope"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ChanMeng666/friendscope","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChanMeng666%2Ffriendscope","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChanMeng666%2Ffriendscope/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChanMeng666%2Ffriendscope/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChanMeng666%2Ffriendscope/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ChanMeng666","download_url":"https://codeload.github.com/ChanMeng666/friendscope/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ChanMeng666%2Ffriendscope/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261338998,"owners_count":23143900,"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":["assessment","data-visualization","framer-motion","friendship","friendship-assessment","lottie-animations","nextjs","privacy-focused","psychology","react","recharts","relationship-analysis","responsive-design","scientific-assessment","shadcn","shadcn-ui","tailwindcss","typescript","zustand"],"created_at":"2024-10-31T01:11:03.822Z","updated_at":"2025-06-22T18:08:43.311Z","avatar_url":"https://github.com/ChanMeng666.png","language":"TypeScript","funding_links":["https://buymeacoffee.com/chanmeng66u"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n \u003ch1\u003e\u003cimg src=\"public/friendscope-logo.svg\" width=\"80px\"\u003e\u003cbr/\u003eFriendScope\u003c/h1\u003e\n \u003ch3\u003eScientific Friendship Assessment Tool\u003c/h3\u003e\n \u003ca href=\"https://friendscope.vercel.app\" target=\"_blank\"\u003e\u003cimg alt=\"\" src=\"https://img.shields.io/badge/View_Demo-blue?style=for-the-badge\" style=\"vertical-align:center\" /\u003e\u003c/a\u003e\n \u003cimg src=\"https://img.shields.io/badge/Next.js-15.0-black?style=for-the-badge\u0026logo=next.js\"/\u003e\n \u003cimg src=\"https://img.shields.io/badge/TypeScript-5.0-blue?style=for-the-badge\u0026logo=typescript\"/\u003e \n \u003cimg src=\"https://img.shields.io/badge/Tailwind_CSS-3.4-38B2AC?style=for-the-badge\u0026logo=tailwind-css\"/\u003e\n \u003cimg src=\"https://img.shields.io/badge/License-GPL3.0-brightgreen?style=for-the-badge\"/\u003e\n\u003c/div\u003e\n\n\u003cbr/\u003e\n\n\nhttps://github.com/user-attachments/assets/a034cb2a-2a8b-4901-b2b7-5c31a9ae32e1\n\n\n![screencapture-friendscope-vercel-app-2024-12-08-18_43_27](https://github.com/user-attachments/assets/edc744f6-db8c-4917-81b3-a63bbf18b19f)\n\n![screencapture-friendscope-vercel-app-about-2024-12-06-01_34_54](https://github.com/user-attachments/assets/da43cb34-a1ef-47d3-aa89-c2e0cea6d778)\n\n![screencapture-friendscope-vercel-app-resources-2024-12-08-18_43_54](https://github.com/user-attachments/assets/2b4b37f5-4a76-4048-b459-812a13029840)\n\n![屏幕截图 2024-12-08 184432](https://github.com/user-attachments/assets/0f784cd2-f2a0-4a25-b38f-2f40b944afae)\n\n![screencapture-friendscope-vercel-app-results-2024-12-08-18_46_32](https://github.com/user-attachments/assets/a78fd693-67af-4254-831a-365525767d3c)\n\n![screencapture-friendscope-vercel-app-history-2024-12-08-18_46_52](https://github.com/user-attachments/assets/94166400-c1c7-4e7f-8a70-b268385e4b99)\n\n\n# ✨ Key Features\n\n### 🔍 Scientific Assessment\n- Comprehensive questionnaire based on psychological research\n- Evaluates 10 key aspects of friendship including trust, communication, and emotional support\n- Evidence-based scoring and analysis\n\n### 📊 Visual Analytics\n- Interactive charts showing different aspects of friendship\n- Real-time visualization of assessment results\n- Historical trend analysis and comparisons\n\n### 🎯 Personalized Insights\n- Tailored recommendations based on assessment results\n- Detailed analysis of friendship strengths and areas for improvement\n- Scientific explanations for all recommendations\n\n### 🔐 Privacy-First\n- No account required\n- All data stored locally\n- Complete anonymity in assessments\n\n### 💫 Modern UX/UI\n- Smooth animations and transitions\n- Interactive and responsive design\n- Intuitive user flow\n\n### 📱 Cross-Platform\n- Fully responsive design\n- Works on all modern browsers\n- Optimized for both desktop and mobile\n\n## 🛠️ Tech Stack\n\n### Core\n- **Framework**: Next.js 15 with TypeScript\n- **Styling**: Tailwind CSS\n- **UI Components**: shadcn/ui\n- **State Management**: Zustand with persist middleware\n\n### Visualization\n- **Charts**: Recharts, Apexcharts\n- **Animations**: Framer Motion\n- **Icons**: Lucide React\n- **Motion Graphics**: Lottie Animations\n\n### Additional Libraries\n- **Date Handling**: date-fns\n- **PDF Generation**: jsPDF\n- **UUID Generation**: uuid\n\n## 🚀 Getting Started\n\n### Prerequisites\n- Node.js (version 18.17.0 or higher)\n- npm or yarn\n\n### Installation\n```bash\n# Clone the repository\ngit clone https://github.com/ChanMeng666/friendscope.git\ncd friendscope\n\n# Install dependencies\nnpm install\n# or\nyarn install\n\n# Start development server\nnpm run dev\n# or\nyarn dev\n```\n\nVisit [http://localhost:3000](http://localhost:3000) to see the application.\n\n## 📁 Project Structure\n```\nfriendscope/\n├── app/                 # Next.js app directory\n│   ├── about/          # About page\n│   ├── assess/         # Assessment flow\n│   ├── results/        # Results visualization\n│   └── page.tsx        # Home page\n├── components/         # React components\n│   ├── ui/            # Reusable UI components\n│   └── layout/        # Layout components\n├── lib/               # Utilities and stores\n├── hooks/             # Custom hooks\n└── public/            # Static assets\n```\n\n## ⚙️ Core Features Explained\n\n### Scientific Assessment Process\n- Evaluates 10 key aspects of friendship\n- Research-based questionnaire design\n- Complex scoring algorithms\n- Personalized result analysis\n\n### Visualization System\n- Radar charts for aspect analysis\n- Trend visualization for progress tracking\n- Interactive data exploration\n- Comparative analysis tools\n\n### Data Management\n- Local storage system\n- Export functionality (PDF/SVG)\n- Historical tracking\n- Progress monitoring\n\n### User Experience\n- Smooth transitions\n- Responsive design\n- Intuitive navigation\n- Real-time feedback\n\n## 🤝 Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n## 📄 License\n\nThis project is licensed under the GPL-3.0 license - see the [GPL-3.0 license](LICENSE) file for details.\n\n## 🙏 Acknowledgments\n\n- UI components inspired by [shadcn/ui](https://ui.shadcn.com/)\n- Icons provided by [Lucide](https://lucide.dev/)\n- Animation assets from [LottieFiles](https://lottiefiles.com/)\n\n## Author\n\n**Chan Meng**\n- LinkedIn: [chanmeng666](https://www.linkedin.com/in/chanmeng666/)\n- GitHub: [ChanMeng666](https://github.com/ChanMeng666)\n\n## ⚡ Tech Used\n![Next JS](https://img.shields.io/badge/Next-black?style=for-the-badge\u0026logo=next.js\u0026logoColor=white)\n![TypeScript](https://img.shields.io/badge/typescript-%23007ACC.svg?style=for-the-badge\u0026logo=typescript\u0026logoColor=white)\n![TailwindCSS](https://img.shields.io/badge/tailwindcss-%2338B2AC.svg?style=for-the-badge\u0026logo=tailwind-css\u0026logoColor=white)\n![React](https://img.shields.io/badge/react-%2320232a.svg?style=for-the-badge\u0026logo=react\u0026logoColor=%2361DAFB)\n![Framer](https://img.shields.io/badge/Framer-black?style=for-the-badge\u0026logo=framer\u0026logoColor=blue)\n![Vercel](https://img.shields.io/badge/vercel-%23000000.svg?style=for-the-badge\u0026logo=vercel\u0026logoColor=white)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchanmeng666%2Ffriendscope","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchanmeng666%2Ffriendscope","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchanmeng666%2Ffriendscope/lists"}