Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/chanmeng666/friendscope
A scientific friendship assessment tool built with Next.js that helps evaluate and improve interpersonal relationships through data-driven insights.
https://github.com/chanmeng666/friendscope
assessment friendship nextjs psychology react recharts shadcn shadcn-ui tailwindcss typescript zustand
Last synced: 15 days ago
JSON representation
A scientific friendship assessment tool built with Next.js that helps evaluate and improve interpersonal relationships through data-driven insights.
- Host: GitHub
- URL: https://github.com/chanmeng666/friendscope
- Owner: ChanMeng666
- Created: 2024-10-30T04:48:07.000Z (16 days ago)
- Default Branch: master
- Last Pushed: 2024-10-30T05:06:17.000Z (16 days ago)
- Last Synced: 2024-10-30T07:29:53.391Z (16 days ago)
- Topics: assessment, friendship, nextjs, psychology, react, recharts, shadcn, shadcn-ui, tailwindcss, typescript, zustand
- Language: TypeScript
- Homepage: https://friendscope.vercel.app
- Size: 218 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# FriendScope (友谱)
FriendScope is a modern web application designed to help individuals evaluate and strengthen their friendships through scientific assessment and personalized insights. Built with Next.js and TypeScript, it offers a user-friendly interface for examining different aspects of interpersonal relationships.
## Features
- 🔍 **Scientific Assessment**: Comprehensive questionnaire based on psychological research
- 📊 **Visual Analytics**: Interactive radar charts showing different aspects of friendship
- 🎯 **Personalized Insights**: Tailored recommendations based on assessment results
- 💫 **Responsive Design**: Seamless experience across all devices
- 🌐 **Bilingual Support**: Interface in both English and Chinese
- 🔐 **Privacy-Focused**: No account required, no data stored
## Tech Stack
- **Framework**: Next.js 15
- **Language**: TypeScript
- **Styling**: Tailwind CSS
- **UI Components**: shadcn/ui
- **State Management**: Zustand
- **Data Visualization**: Recharts
- **Deployment**: Vercel
## Getting Started
### Prerequisites
- Node.js (version 18.17.0 or higher)
- npm or yarn
### Installation
1. Clone the repository
```bash
git clone https://github.com/ChanMeng666/friendscope.git
cd friendscope
```
2. Install dependencies
```bash
npm install
# or
yarn install
```
3. Run the development server
```bash
npm run dev
# or
yarn dev
```
4. Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
## Project Structure
```
friendscope/
├── app/ # Next.js app directory
│ ├── about/ # About page
│ ├── assess/ # Assessment page
│ ├── results/ # Results page
│ └── page.tsx # Home page
├── components/ # React components
│ ├── ui/ # UI components
│ └── layout/ # Layout components
├── lib/ # Utilities and stores
├── hooks/ # Custom hooks
└── public/ # Static files
```
## 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 MIT License - see the [LICENSE](LICENSE) file for details.
## Acknowledgments
- UI components based on [shadcn/ui](https://ui.shadcn.com/)
- Design inspiration from various friendship assessment tools
- Special thanks to all contributors and users of FriendScope
## Contact
[ChanMeng666]([ChanMeng666 (Chan Meng)](https://github.com/ChanMeng666))
Project Link: [ChanMeng666/friendscope: A scientific friendship assessment tool built with Next.js that helps evaluate and improve interpersonal relationships through data-driven insights.](https://github.com/ChanMeng666/friendscope)
---
Built with ❤️ using Next.js