SpeakFeel - Emotional Vocabulary Growth

SpeakFeel is an interactive web app designed to help users expand their emotional vocabulary by connecting emotions to nuanced words and definitions. Through a simple emoji-based interface, users can explore different emotional states, learn related submoods, and gain a deeper understanding of how to express their feelings.

Features

Interactive Emoji-Based Interface: Choose from various core emotions like joy, sadness, anger, fear, surprise, and love.
Emotional Vocabulary Expansion: Learn related submoods (nuanced emotional states) and their detailed definitions.
User Privacy: No data is stored or shared — the app is completely private.

Technology Stack

Frontend: React
Deployment: GitHub Pages
Styling: CSS Flexbox/Grid for layout, responsive design

Live Demo

Check out the live app here: SpeakFeel on GitHub Pages

Installation & Setup

To run this project locally, follow these steps:

1. Clone the repository:

git clone https://github.com/RedBeret/speakfeel.git
cd speakfeel

2. Install dependencies:

Make sure you have Node.js installed, then run:

npm install

3. Start the development server:

npm start

This will start the app in development mode. Open http://localhost:3000 to view it in the browser.

4. Build for production:

To create an optimized production build, run:

npm run build

5. Deploy to GitHub Pages:

The project is configured for deployment using GitHub Pages. To deploy, simply run:

npm run deploy

How to Use

Select an emotion by clicking on an emoji that represents your current mood.
SpeakFeel will randomly select a submood from the chosen emotion and display its definition.
Use this expanded vocabulary to express your feelings more accurately.

Contributing

Contributions are welcome! If you have any suggestions, feature requests, or bug fixes, feel free to open an issue or submit a pull request.

Steps to Contribute:

Fork the repository.
Create a new branch for your feature or bug fix:
```
git checkout -b feature/new-feature
```
Commit your changes:
```
git commit -m "Add new feature"
```
Push to your branch:
```
git push origin feature/new-feature
```
Open a Pull Request.

License

This project is licensed under the MIT License

RedBeret/speakfeel