Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/chanmeng666/friendscope
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.
https://github.com/chanmeng666/friendscope
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
Last synced: 11 days ago
JSON representation
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.
- Host: GitHub
- URL: https://github.com/chanmeng666/friendscope
- Owner: ChanMeng666
- License: gpl-3.0
- Created: 2024-10-30T04:48:07.000Z (2 months ago)
- Default Branch: master
- Last Pushed: 2024-12-14T03:11:34.000Z (16 days ago)
- Last Synced: 2024-12-18T15:10:01.922Z (11 days ago)
- 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
- Language: TypeScript
- Homepage: https://friendscope.vercel.app
- Size: 521 KB
- Stars: 4
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
FriendScope
Scientific Friendship Assessment Tool
https://github.com/user-attachments/assets/a034cb2a-2a8b-4901-b2b7-5c31a9ae32e1
# ✨ Key Features
### 🔍 Scientific Assessment
- Comprehensive questionnaire based on psychological research
- Evaluates 10 key aspects of friendship including trust, communication, and emotional support
- Evidence-based scoring and analysis
### 📊 Visual Analytics
- Interactive charts showing different aspects of friendship
- Real-time visualization of assessment results
- Historical trend analysis and comparisons
### 🎯 Personalized Insights
- Tailored recommendations based on assessment results
- Detailed analysis of friendship strengths and areas for improvement
- Scientific explanations for all recommendations
### 🔐 Privacy-First
- No account required
- All data stored locally
- Complete anonymity in assessments
### 💫 Modern UX/UI
- Smooth animations and transitions
- Interactive and responsive design
- Intuitive user flow
### 📱 Cross-Platform
- Fully responsive design
- Works on all modern browsers
- Optimized for both desktop and mobile
## 🛠️ Tech Stack
### Core
- **Framework**: Next.js 15 with TypeScript
- **Styling**: Tailwind CSS
- **UI Components**: shadcn/ui
- **State Management**: Zustand with persist middleware
### Visualization
- **Charts**: Recharts, Apexcharts
- **Animations**: Framer Motion
- **Icons**: Lucide React
- **Motion Graphics**: Lottie Animations
### Additional Libraries
- **Date Handling**: date-fns
- **PDF Generation**: jsPDF
- **UUID Generation**: uuid
## 🚀 Getting Started
### Prerequisites
- Node.js (version 18.17.0 or higher)
- npm or yarn
### Installation
```bash
# Clone the repository
git clone https://github.com/ChanMeng666/friendscope.git
cd friendscope
# Install dependencies
npm install
# or
yarn install
# Start development server
npm run dev
# or
yarn dev
```
Visit [http://localhost:3000](http://localhost:3000) to see the application.
## 📁 Project Structure
```
friendscope/
├── app/ # Next.js app directory
│ ├── about/ # About page
│ ├── assess/ # Assessment flow
│ ├── results/ # Results visualization
│ └── page.tsx # Home page
├── components/ # React components
│ ├── ui/ # Reusable UI components
│ └── layout/ # Layout components
├── lib/ # Utilities and stores
├── hooks/ # Custom hooks
└── public/ # Static assets
```
## ⚙️ Core Features Explained
### Scientific Assessment Process
- Evaluates 10 key aspects of friendship
- Research-based questionnaire design
- Complex scoring algorithms
- Personalized result analysis
### Visualization System
- Radar charts for aspect analysis
- Trend visualization for progress tracking
- Interactive data exploration
- Comparative analysis tools
### Data Management
- Local storage system
- Export functionality (PDF/SVG)
- Historical tracking
- Progress monitoring
### User Experience
- Smooth transitions
- Responsive design
- Intuitive navigation
- Real-time feedback
## 🤝 Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
1. Fork the repository
2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request
## 📄 License
This project is licensed under the GPL-3.0 license - see the [GPL-3.0 license](LICENSE) file for details.
## 🙏 Acknowledgments
- UI components inspired by [shadcn/ui](https://ui.shadcn.com/)
- Icons provided by [Lucide](https://lucide.dev/)
- Animation assets from [LottieFiles](https://lottiefiles.com/)
## Author
**Chan Meng**
- LinkedIn: [chanmeng666](https://www.linkedin.com/in/chanmeng666/)
- GitHub: [ChanMeng666](https://github.com/ChanMeng666)
## ⚡ Tech Used
