Tshwetso K. Mokgatlhe

Student Number: 221411

DV300 | Interaction Development | 2025

TimeLink

Stay connected, across time and memory. A cross-platform journaling & time capsule app.
Explore the docs »

View Demo · Report Bug · Request Feature

---

Table of Contents

• About the Project
  • Project Description
  • Built With
• Getting Started
  • Prerequisites
  • How to Install
• Features and Functionality
• Concept Process
• Development Process
• Final Outcome
• Roadmap
• Contributing
• License
• Contact
• Acknowledgements

---

🧠 About the Project

![image1][image1]

Project Description

TimeLink is a cross-platform (iOS & Android) React Native app built with Expo and TypeScript.
It helps users preserve connections across time through Daily Journals and Scheduled Time Capsules—messages that resurface at meaningful future moments.
The UI has landscape affinity, and the backend uses Firebase for authentication, storage, and real-time data.

Built With

• Expo SDK 54
• React Native 0.81
• TypeScript 5
• Firebase Auth & Firestore
• Reanimated 4 + Moti
• React Navigation v7
• Expo Image Picker

---

🚀 Getting Started

Prerequisites

• Node.js LTS (≥ 18)
• Expo Go app (Android/iOS)
• A configured Firebase project with Auth, Firestore, and Storage

How to Install

# Clone repository
git clone https://github.com/TshwetsoMo/TimeLinked.git
cd TimeLinked

Install dependencies

npm install

Start Expo server (tunnel recommended)

npx expo start --tunnel

---

📱 Expo Go Tips

• If QR scan does not load the app:

  • Use tunnel mode.
  • Ensure phone and computer are on the same Wi-Fi if using LAN.
  • Disable VPN or firewall, or keep using --tunnel.

• Android USB development:

  npx expo start --localhost
  adb reverse tcp:8081 tcp:8081

---

🎨 Mockups

👨‍💻 Developer Contact

• Name: Tshwetso K. Mokgatlhe
• Email: tshwetsomokgatlhe98@gmail.com
• Portfolio: [Coming Soon]
• GitHub: https://github.com/TshwetsoMo/TimeLinked.git
• Student number: 221411
• Course code: DV300

---

🐛 Troubleshooting

• TypeScript "Cannot find module ..." - check relative paths and ensure files exist (/navigation/AppNavigation.tsx, /theme/useTheme.ts, etc.)
• Reanimated errors or blank screen - confirm Babel plugin and clear cache
• Auth "network request failed" - verify Firebase config and device connectivity
• Expo Go fails to connect - use --tunnel or disable VPN/firewall, remove legacy global CLI

---

📜 License

© 2025 TimeLink. Coursework and personal portfolio use.

---

📫 Contact

• Tshwetso K. Mokgatlhe – tshwetsomokgatlhe98@gmail.com
• GitHub: github.com/TshwetsoMo/TimeLinked
• LinkedIn: linkedin.com/in/tshwetsomokgatlhe
• Behance: Behance

---

🙏 Acknowledgements

• Expo Docs
• Firebase Docs
• React Navigation
• Open Window DV300 Lecturers
• Moti Animations
• Reanimated 4