A futuristic, self-hosted project portfolio built using Flask, HTML/CSS/JS & Three.js 🌌
Think of it as your own personal cosmic GitHub — themed, optimized, and beautiful.

I built AstroHub as a lightweight and visually rich alternative to GitHub — giving myself more control over how I present my work, especially during hackathons, client demos, and tech portfolios.

• ✅ User-Added Projects – Users can now submit their own GitHub repo links and descriptions to showcase on AstroHub
• 📦 ZIP File Downloads – Each project includes an optional ZIP download link stored on Google Drive (secured)
• 🧾 Dynamic Project Cards – Backend updated to load user-submitted projects
• 🛠️ Bug Fixes – Previous version lacked external project submission and ZIP support

• 🌠 Starry animated background using Three.js
• 📂 Project cards with title, description, GitHub link, and Google Drive ZIP download
• 🔐 User login/signup with Flask-Login
• 📝 Add your own project using GitHub link + Drive ZIP
• 🛰️ Fully responsive and mobile-friendly layout
• 🛸 Glowing neon blue alien theme (Dark Mode by default)

• 🛤️ Route Management – Faced issues where Flask routes didn’t match HTML paths, causing broken links & redirects.
• 🗄️ Database Issues – MySQL on localhost stopped working, so I switched to an SQLite DB (AstroDB.sqlite3) inside the project.
• 🔑 Login Redirect – Sometimes after pressing login, the app didn’t go to the dashboard due to session & redirection bugs.

AstroHub/ │ ├── app.py # Main Flask app ├── instance/ │ ├── astro.db # Data Base For Projects & Users Details ├── templates/ │ ├── index.html # Landing page │ ├── login.html # Login page │ ├── signup.html # Signup page │ ├── dashboard.html # Projects page │ ├── add_project.html # Add New Projects as Per User │ ├── static/ │ ├── css/ # Styles │ ├── js/ # Starfield animation (Three.js) │ ├── preview/ # Downloadable files │ └── images/ # Assets like logos │ ├── config.json # Configuration └── README.md # This file

# 1. Clone this repo
git clone https://github.com/ck-ahmad/AstroHub.git
cd AstroHub

# 2. Set up a virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# 3. Install dependencies
pip install -r requirements.txt

# 4. Run the app
python app.py

# Open in browser
http://127.0.0.1:5000/
🧠 Project Showcase (Inside AstroHub)
Like:
🔗 TONY AI – Personal Assistant
🔗 Google Drive Clone (C++)
🔗 Student Assistant Helper
🔗 + Add your own via GitHub & Drive! 

🌐 Live Demo
🚧 Coming Soon on Render/Vercel
✅ Meanwhile, view demo video above ☝️

🤖 Author
Ahmad 
🔗 GitHub Profile
📫 Links in bio

📜 License
MIT License – Free to fork, build on, and use.
AstroHub was built for the open-source galaxy 🌌

markdown
Copy
Edit

Would you like:
- ✅ A sample `config.json`?
- ✅ A generated `requirements.txt`?
- ✅ Flask route and form logic for submitting project name + repo + ZIP link?