📲 PrintLn

A modern social network focused on mobile experience, secure authentication, and cloud services integration.

---

📌 About the Project

PrintLn is a mobile social network developed to offer a seamless content sharing experience, focusing on performance, simplicity, and integration with modern cloud services.

Users can create posts with text and images, interact with their own publications, and utilize native device features such as the camera and geolocation.

Key Features:

• 🔐 User registration and authentication
• 📝 Create, read, update, and delete (CRUD) posts and comments
• 📸 Image upload using camera or gallery
• 📍 Geolocation integration (city/state)
• ❤️ Real-time publication feed
• 💾 Save posts functionality
• 👤 Username and profile picture updates
• 🌙 Built-in app dark mode
• 📱 Responsive mobile interface

🧪 Test Access:

If you want to quickly explore the application without creating an account, use the demonstration login:

E-mail: matheus@gmail.com
Password: 123456

🧠 Core Differentials

• ⚡ Mobile-first experience
• 🔄 Reactive state management with MobX
• 🌐 Decoupled architecture (Frontend + Backend API)
• 📍 Hybrid geolocation (Web + Mobile)
• ☁️ Integration with external cloud services
• 🧩 Scalable and modular

📱 App Preview

Main Feed	Secure Login	Profile

Create Post	Comments	Light Mode

🛠️ Tech Stack

📱 Frontend (Flutter)

⚙️ Backend and Services

🌐 Deployment

🧱 System Architecture

Flutter App (PrintLn)
      ↓
FastAPI (REST Backend)
      ↓
Firebase Auth → authentication
Cloudinary → images
PostgreSQL → data

💻 How to Run the Project Locally

📱 Frontend (Flutter)

Navigate to the project directory:

cd println

Install dependencies:

flutter pub get

Run the app:

flutter run

⚙️ Backend (FastAPI)

Navigate to the project directory:

cd api_println

Create a virtual environment:

python -m venv venv

Activate the virtual environment:

.\venv/bin/activate

Install dependencies:

pip install -r requirements.txt

Run the API:

uvicorn main:app --host 0.0.0.0 --port 8000

⚙️ Environment Variables

Create a .env file in the root of the api_println directory with the following configuration:

# Cloudinary
CLOUDINARY_CLOUD_NAME
CLOUDINARY_API_KEY
CLOUDINARY_API_SECRET

# Neon
DATABASE_URL

# PyJWT
JWT_SECRET_KEY
JWT_ALGORITHM
JWT_EXPIRE_MINUTES

# Firebase
FIREBASE_API_KEY
FIREBASE_CREDENTIALS_JSON

📈 Future Enhancements

• 🧪 Automated backend and frontend testing
• 🔐 Email password recovery
• 🔔 Real-time push notifications
• 👥 Friends, followers, and following system
• 📰 Personalized feed from followed users
• 🔍 User and publication filters
• 📊 User metrics dashboard

📄 License

This project is available for study, portfolio, and learning purposes. Feel free to fork it, enhance the solution, and build new improvements on top of it.

👨‍💻 Author

Matheus Lula

Full-Stack Developer • React • Flutter • FastAPI • AI & Automation