🌊 Fluxa

The social network built for developers, by developers.

Share your projects. Document your journey. Grow in public.

Features · Screenshots · Tech Stack · Installation · Roadmap · Contributing

---

📖 About Fluxa

Fluxa is an open-source social platform designed specifically for developers. It gives programmers a dedicated space to share their projects, document their progress, showcase their tech stack, and connect with other developers — all in public.

Inspired by the best of GitHub, Twitter/X, and Dev.to, Fluxa focuses on what developers care about most: projects, growth, and community. Whether you're building a side project, learning a new technology, or looking for collaborators, Fluxa is the place to share it.

Build in public. Grow with the community.

---

📸 Screenshots

👤 Profile Page

⚙️ Profile Settings

🚀 Create Project

---

✨ Features

👤 User Profiles

Every developer on Fluxa has a rich public profile that tells their story at a glance.

• Profile picture — Upload and manage your developer avatar
• Bio — Tell the community who you are and what you build
• Location — Let others know where you're based
• Website / Portfolio — Link your profile to your personal site
• Project counter — Automatically updated with your published projects
• Followers & Following — Build your network within the platform
• Activity streak — Track and display your consistency streak
• Resume download — Export your full developer profile as a polished PDF with a single click, powered by html2pdf.js

---

🗂️ Projects

The core of Fluxa is sharing what you build.

• Publish projects — Create a dedicated page for each of your projects
• Title & Description — Present your project clearly with rich text support
• Tech stack tags — Tag every technology used so others can find your work by stack
• Media gallery — Upload screenshots, demos, or banners via Cloudinary

---

📰 Activity Feed

Stay up to date with what the community is building.

• A real-time feed of projects and updates from the developers you follow
• See the latest published projects, new profiles, and recent activity all in one place
• A discovery hub to explore what's happening across the entire platform

---

🔍 Explore Page

Discover the best of what Fluxa has to offer.

• Trending projects — The projects with the most traction right now
• Recent projects — The latest additions to the platform
• Developers to follow — Suggested developer profiles to connect with
• Filter and browse by technology to find projects in your stack

---

🏷️ Tech Stack Tags

• Add technology tags to your projects (e.g., Laravel, React, PostgreSQL, Docker)
• Tags are searchable and browsable across the entire platform
• Helps others discover projects built with specific tools

---

📄 Profile Resume Export

• Generate a clean, resume-formatted PDF from your Fluxa developer profile
• Includes your bio, location, tech stack, projects, and social stats
• Powered by html2pdf.js — no server-side rendering required
• One-click download directly from your public profile page

---

⚙️ Settings

• Profile editing — Update your photo, bio, location, and website at any time
• Account preferences — Manage your username, email, and notification options
• Security options — Change your password and manage active sessions

---

🛠️ Tech Stack

Layer	Technology
Backend	Laravel
Frontend	Blade Templates + Tailwind CSS
Authentication	Laravel Breeze
Media Storage	Cloudinary
Infrastructure	Docker + Laravel Sail
PDF Export	html2pdf.js
Database	MySQL (via Sail)

---

⚡ Installation

Requirements

Before getting started, make sure you have the following installed on your machine:

• Docker Desktop (v24 or higher recommended)
• Git
• A terminal with bash support

Note: Laravel Sail manages PHP, Composer, Node, and all other dependencies inside Docker containers. You do not need to install PHP or Composer locally.

---

1. Clone the Repository

git clone https://github.com/Angel121954/fluxaRedSocial.git
cd fluxa

---

2. Copy the Environment File

cp .env.example .env

---

3. Configure Environment Variables

Open the .env file and fill in the required values:

# Application
APP_NAME=Fluxa
APP_URL=http://localhost

# Database (Sail defaults — only change if needed)
DB_CONNECTION=mysql
DB_HOST=mysql
DB_PORT=3306
DB_DATABASE=fluxa
DB_USERNAME=sail
DB_PASSWORD=password

# Cloudinary — get your credentials at https://cloudinary.com
CLOUDINARY_URL=cloudinary://API_KEY:API_SECRET@CLOUD_NAME
CLOUDINARY_CLOUD_NAME=your_cloud_name
CLOUDINARY_API_KEY=your_api_key
CLOUDINARY_API_SECRET=your_api_secret

⚠️ Never commit your real .env file to version control. It is already included in .gitignore.

---

4. Install PHP Dependencies via Docker

If you don't have Composer installed locally, use this Docker command to install the dependencies:

docker run --rm \
    -u "$(id -u):$(id -g)" \
    -v "$(pwd):/var/www/html" \
    -w /var/www/html \
    laravelsail/php83-composer:latest \
    composer install --ignore-platform-reqs

---

5. Start Laravel Sail

./vendor/bin/sail up -d

This will spin up the following containers:

Container	Description
fluxa_laravel	Laravel application (PHP 8.3)
fluxa_mysql	MySQL database
fluxa_redis	Redis for queues and caching
fluxa_mailpit	Local mail capture for development

---

6. Generate the Application Key

./vendor/bin/sail artisan key:generate

---

7. Run Database Migrations

./vendor/bin/sail artisan migrate

---

8. (Optional) Seed the Database

Populate the database with sample data for local development:

./vendor/bin/sail artisan db:seed

---

9. Install Frontend Dependencies and Compile Assets

./vendor/bin/sail npm install
./vendor/bin/sail npm run dev

For a production build:

./vendor/bin/sail npm run build

---

✅ Access the Application

Once all steps are complete, open your browser and visit:

http://localhost

---

🗂️ Project Structure

fluxa/
├── app/
│   ├── Http/
│   │   ├── Controllers/        # Application controllers
│   │   └── Requests/           # Form validation (Form Requests)
│   ├── Models/                 # Eloquent models (User, Project, Follow...)
│   └── Services/               # Business logic services
├── database/
│   ├── migrations/             # Database schema
│   └── seeders/                # Seeders with sample data
├── docs/                       # Project screenshots for the readme
├── public/
│     ├── css/                  # Custom view styles
│     └── js/                   # JavaScript (includes html2pdf.js usage)
├── resources/
│   ├── views/                  # Blade templates
│   │   ├── auth/               # Authentication views
│   │   ├── components/         # Reusable components for other views
│   │   ├── layouts/            # Base layouts
│   │   ├── profile/            # Profile-related views
│   │   ├── projects/           # Project views
│   │   ├── feed/               # Feed views
│   │   └── explore/            # Explore page views
│   └── css/                    # Tailwind entry point
├── routes/
│   ├── web.php                 # Web routes
│   └── auth.php                # Authentication routes
├── docker-compose.yml          # Sail / Docker configuration
└── .env.example                # Environment variable template

---

🗺️ Roadmap

Fluxa is in active development. Here's what's coming next:

• 💬 Project comments — Allow developers to leave comments and feedback on any project
• ❤️ Project likes — React to projects with likes and highlight the most appreciated ones
• 🔔 Notification system — Real-time notifications for follows, comments, and activity
• ✅ Developer verification — Badge system to verify active and trusted contributors
• 🔌 Public API — RESTful API for third-party integrations and developer tooling
• 🌐 Internationalization (i18n) — Full multi-language support across the entire platform
• 🔎 Advanced search — Full-text search across projects, profiles, and tags
• 📊 Analytics dashboard — Stats and insights for your own profile and projects

Have an idea? Open a feature request — contributions and suggestions are always welcome.

---

🤝 Contributing

Contributions are what make open-source projects thrive. Every contribution, no matter how small, is appreciated and valued.

How to Contribute

1. Fork the repository
2. Create your feature branch:

   git checkout -b feature/your-feature-name
   

3. Commit your changes with a clear message:

   git commit -m "feat: add project likes feature"
   

4. Push your branch:

   git push origin feature/your-feature-name
   

5. Open a Pull Request — clearly describe your changes and link any related issues

Guidelines

• Follow the existing code style and conventions
• Write clear and descriptive commit messages (we recommend Conventional Commits)
• Add comments to complex logic
• Test your changes locally before opening a PR
• Be respectful and constructive in all communications

Please read our CONTRIBUTING.md for the full contribution guidelines.

---

🐛 Reporting Issues

Found a bug? Have a question? Open an issue and we'll get back to you as soon as possible.

Please include:

• A clear description of the problem
• Steps to reproduce it
• Expected behavior vs actual behavior
• Your environment (OS, Docker version, browser)

---

📄 License

This project uses a Proprietary License — see the LICENSE file for full details.

What you CAN do:

• Study and learn from the code structure
• Use it for personal/learning projects
• Use it as reference for learning architectures and patterns

What you CANNOT do:

• Use it commercially or as SaaS
• Create a competing social network
• Sell or redistribute the code

For commercial licensing, contact the project owner.

---