Skip to content

MevinManuel/Pinion

Repository files navigation

📍 Pinion

Pinion is a Geo-Based Storytelling App that allows users to pin personal stories, experiences, or thoughts to real-world locations. It transforms maps into a canvas of shared memories and local tales.


🗺️ What is Pinion?

Pinion is designed to connect people through places. Whether it’s a hidden beach story, a college memory, or a historical fact—users can add location-based pins with rich context and content. Think of it as a digital memory map.


🔥 Features

  • 🗺️ Interactive Google Map Integration
    A seamless and responsive map interface using Google Maps SDK, allowing users to pan, zoom, and explore locations with ease.

  • 📍 Custom Location-Based Pins
    Users can tap anywhere on the map to drop a pin and attach a short story, memory, or note to that exact location.

  • 📝 Story Creation & Preview
    Each pin includes a form to enter a title and a detailed description. Pins are saved and can be revisited or edited later (persistent storage to be added).

  • 🎨 Clean & Minimal UI
    Designed with user experience in mind—distraction-free layout with focus on storytelling and interaction.

  • 📱 Mobile-first Experience
    Fully optimized for Android devices. Can be run via USB for local development, with plans for production builds.

  • 📦 Modular Codebase
    The app is structured for easy extension—whether adding authentication, backend support, or map providers like OpenStreetMap in the future.


🛠️ Tech Stack

  • Frontend: React Native (Expo)
  • Map Integration: Google Maps
  • Platform: Android (tested via USB & emulator)
  • Version Control: Git + GitHub

🚀 Getting Started

Prerequisites

  • Node.js
  • Expo CLI
  • Android Studio (for running on a physical/emulated device)
  • Git

Installation

git clone https://github.com/MevinManuel/Pinion.git
cd Pinion
npm install
Run the App on Android (USB Device)
bash
Copy
Edit
npx react-native run-android

Make sure:

USB debugging is enabled on your Android device

Your device is connected properly

You’ve accepted the debugging prompt on your phone

🖼️ Sample Screenshot

mockup_pinion m IMG-20250416-WA0006 IMG-20250416-WA0008 IMG-20250416-WA0011 n IMG-20250416-WA0007 IMG-20250416-WA0009 IMG-20250416-WA0010

📌 Roadmap Implement OpenStreetMap support (planned)

Add user authentication (completed)

Backend for storing pinned stories (completed)

Profile pages and likes/comments (completed)

🤝 Contributing Pull requests are welcome! For major changes, please open an issue first to discuss what you would like to change.

📄 License This project is licensed under the MIT License.

Made with 💚 by Mevin Manuel

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published