An open API service indexing awesome lists of open source software.

https://github.com/jabramyk/mo-portfolio-2025

Showcase your skills with Mohamed Datt's creative portfolio. Explore projects built with Next.js, TypeScript, and TailwindCSS. 🌟👨💻
https://github.com/jabramyk/mo-portfolio-2025

aceternity-ui ai chatbot frammer-motion gemini-api github github-api groq-api interactive nextjs react rpg-game storytelling terminal-based typescript vercel

Last synced: 4 months ago
JSON representation

Showcase your skills with Mohamed Datt's creative portfolio. Explore projects built with Next.js, TypeScript, and TailwindCSS. 🌟👨💻

Awesome Lists containing this project

README

          

# Terminal-Inspired Developer Portfolio: A Unique Journey

![Portfolio Banner](https://img.shields.io/badge/Portfolio%20Release-Download%20Now-brightgreen)

## Overview

Welcome to the **mo-portfolio-2025** repository! This project showcases an interactive, AI-powered developer portfolio designed using **Next.js**, **TypeScript**, and **TailwindCSS**. It features a terminal adventure game, live GitHub integration, and a creative storytelling journey from Guinea to Virginia.

Explore my journey, play the game, chat with AI bots trained on my story, and discover real projects. This portfolio is not just a showcase; it's an experience.

### Key Features

- **Terminal Adventure Game**: Immerse yourself in a unique RPG experience that blends storytelling with interactive gameplay.
- **Live GitHub Integration**: View real-time updates from my GitHub projects, ensuring you always see my latest work.
- **AI Chatbots**: Engage with AI bots that share insights and stories from my journey.
- **Creative Storytelling**: Discover my path from Guinea to Virginia through engaging narratives and visuals.

## Getting Started

To get started with this project, you can download the latest release from the [Releases section](https://github.com/jabramyk/mo-portfolio-2025/releases). Follow the instructions to execute the files and explore the portfolio.

### Prerequisites

Before running the project, ensure you have the following installed:

- **Node.js**: This project is built on Node.js. Download it from [Node.js Official Site](https://nodejs.org/).
- **npm**: This comes with Node.js, but you can check your version by running `npm -v` in your terminal.

### Installation

1. Clone the repository:

```bash
git clone https://github.com/jabramyk/mo-portfolio-2025.git
```

2. Navigate into the project directory:

```bash
cd mo-portfolio-2025
```

3. Install the dependencies:

```bash
npm install
```

4. Run the development server:

```bash
npm run dev
```

5. Open your browser and navigate to `http://localhost:3000` to see the portfolio in action.

## Features Breakdown

### Terminal Adventure Game

This portfolio includes a terminal-based RPG game that allows users to engage with a story. Players navigate through various challenges and decisions, all while learning about my experiences and skills.

- **Game Mechanics**: Simple command-line inputs allow for easy navigation and interaction.
- **Storyline**: The game tells my journey from Guinea to Virginia, with choices that reflect real-life experiences.

### Live GitHub Integration

Stay updated with my latest projects. The portfolio integrates directly with the GitHub API to fetch and display my repositories in real-time.

- **Real-Time Updates**: View the latest commits and project statuses.
- **Interactive Elements**: Clickable links to my GitHub repositories for deeper exploration.

### AI Chatbots

Engage with AI bots that are trained on my personal stories and experiences. These bots provide a unique way to learn more about my background and skills.

- **Interactive Conversations**: Ask questions and receive tailored responses based on my journey.
- **Story Sharing**: Bots share anecdotes and lessons learned throughout my career.

### Creative Storytelling

The portfolio showcases a blend of visuals and narratives that detail my path. From Guinea to Virginia, every section tells a part of my story.

- **Visuals**: Engaging images and graphics enhance the storytelling experience.
- **Narratives**: Written content that provides context and depth to my experiences.

## Technologies Used

This project leverages several modern technologies to deliver a seamless experience:

- **Next.js**: A React framework that enables server-side rendering and static site generation.
- **TypeScript**: Adds static type definitions to JavaScript, enhancing code quality and maintainability.
- **TailwindCSS**: A utility-first CSS framework that allows for rapid UI development.

### Additional Technologies

- **Framer Motion**: For smooth animations and transitions.
- **Gemini API**: Used for AI functionalities.
- **GitHub API**: For live project integration.
- **GROQ API**: For data fetching and management.

## Topics Covered

This repository covers a variety of topics relevant to modern web development and interactive applications:

- **AI**
- **Chatbot**
- **Command-Line**
- **Framer Motion**
- **Gemini API**
- **GitHub API**
- **GROQ API**
- **Interactive**
- **Next.js**
- **Portfolio Website**
- **React**
- **RPG Game**
- **Storytelling**
- **Terminal-Based**
- **TypeScript**
- **Vercel**

## Contribution

Contributions are welcome! If you have suggestions for improvements or features, feel free to open an issue or 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.

## Contact

For any inquiries or feedback, please reach out to me through GitHub or my personal website.

## Release Information

You can download the latest release from the [Releases section](https://github.com/jabramyk/mo-portfolio-2025/releases). Make sure to check it out for the most recent updates and features.

![Portfolio Footer](https://img.shields.io/badge/Explore%20My%20Journey-Start%20Now-blue)

## Acknowledgments

- Special thanks to the open-source community for their invaluable contributions.
- Inspiration from various developers and projects that pushed the boundaries of interactive storytelling.

## Future Plans

- Enhance the terminal game with new features and levels.
- Expand the AI chatbot capabilities for more engaging interactions.
- Integrate more personal projects to showcase a broader skill set.

Feel free to explore, play, and engage with my portfolio. I hope you enjoy the experience as much as I enjoyed creating it!