KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #dsh #dsh-plugin #ai-agent #claude-code #codex #typescript #ai-agents #mcp #cli #rust #deepseek-harness

globuddy

★ 128 Open GitHub ↗

Explore friends around the world interactively using AR and 3D visualizations.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![Swift](https://img.shields.io/badge/Swift-v5-orange) ![SwiftUI](https://img.shields.io/badge/-SwiftUI-blue) ![iOS](https://img.shields.io/badge/iOS-15%2B-blueviolet) ![macOS](https://img.shields.io/badge/macOS-Sonoma-red) [![All Contributors](https://img.shields.io/badge/contributors-1-orange)](https://raw.githubusercontent.com/bahattinkoc/globuddy/main/)

</div>

# GloBuddy 🌍

**An interactive way to explore friends around the world using AR and 3D visualizations.**

## Overview

GloBuddy is a project built with SwiftUI and SceneKit that lets you explore a 3D earth to discover friends from different countries. You can interact with profiles by tapping on their location, view their details animatedly at the top of the screen, and even simulate sending a message directly. This project is designed to experiment with AR, animations, and 3D interactions in a fun and visually appealing way.

## Features ✨

- **3D Earth Exploration**: Navigate and interact with a 3D earth model to discover friends located around the world.
- **Profile Interactions**: Tap on any profile marker to see detailed information about that friend, complete with animations.
- **AR & SceneKit Integration**: Combined AR technologies and 3D interactions to create a smooth and engaging experience.

## Technologies Used 🛠️

- **SwiftUI**: For creating beautiful user interfaces.
- **SceneKit**: To create and manipulate the 3D earth and user interactions.

## Installation 🚀

To run the project locally:

1. **Clone the repository**:
    ```bash
    git clone https://github.com/bahattinkoc/globuddy.git
    ```

2. **Open the project in Xcode**:
    ```bash
    cd globuddy
    open gloguddy.xcodeproj
    ```

3. **Build and Run**:
    Make sure you are running on a real device to experience AR functionality.

## Usage 💡

- Launch the app and explore the 3D earth.
- Tap on profile markers to view detailed information about friends.
- Use the message button to simulate sending a message.
- Enjoy a smooth AR experience as you interact with the world.

## Video Demo 🎥

Check out the full demo video:
<div align="center">
  
https://github.com/user-attachments/assets/65d5b631-d462-4f72-8915-f58b316ee219

</div>

## Contributing to globuddy

We :heart: your feedback! If you notice any bug or want a new feature, just [open an Issue](https://github.com/bahattinkoc/globuddy/issues/new)!

We also encourage you to make changes to the code - refactor it, add a feature, fix a typo. Even the smallest change counts!

Just follow these steps:

1. [Fork](https://help.github.com/articles/fork-a-repo/) the repository.
2. Create a [Feature Branch](https://help.github.com/articles/creating-and-deleting-branches-within-your-repository/) for your changes.
3. Make the changes to the code.
4. Create a [Pull Request](https://help.github.com/articles/creating-a-pull-request/).
5. After reviewing the code, we'll merge your changes!

If you like our work give us a :star: :)

## Authors and Contributors

- [Bahattin Koc](https://github.com/bahattinkoc) ([@baaddink](https://twitter.com/baaddink)) - development & design

## Acknowledgments 🙏

- **[onirix](https://linkedin.com/company/onirixar/)** for providing the amazing earth model.
- Special thanks to the open-source community for support and inspiration.

## Contact 📬

Feel free to reach out via [LinkedIn](https://linkedin.com/in/uikit) or follow me on [Twitter](https://twitter.com/baaddink) for more updates.

---

Enjoy exploring the world with GloBuddy! 🌍✨

globuddy

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README