project intial setup done

Author: osama2kabdullah

.github/workflows/deploy.yml

@@ -1,4 +1,4 @@
-node_modules/
-.cache/
-public
-src/gatsby-types.d.ts
+__pycache__/
+venv
+.env
+run_project.bat

.gitignore

@@ -1,49 +1,110 @@
-<p align="center">
-  <a href="https://www.gatsbyjs.com/?utm_source=starter&utm_medium=readme&utm_campaign=minimal-starter-ts">
-    <img alt="Gatsby" src="https://www.gatsbyjs.com/Gatsby-Monogram.svg" width="60" />
-  </a>
-</p>
-<h1 align="center">
-  Gatsby Minimal TypeScript Starter
-</h1>
+# Portfolio Template
 
-## 🚀 Quick start
+This is a portfolio landing page builder. Users can register, create a profile, and get a public link to share. I personally use this web app to build my own portfolio landing page.
 
-1.  **Create a Gatsby site.**
+---
 
-    Use the Gatsby CLI to create a new site, specifying the minimal TypeScript starter.
+## 🔧 Tech Stack
 
-    ```shell
-    # create a new Gatsby site using the minimal TypeScript starter
-    npm init gatsby -- -ts
-    ```
+- **Backend:** Flask (Python)
+- **Frontend:** Bootstrap, HTML, CSS, JS
+- **Database:** PostgreSQL
+- **Templating:** Jinja2 (default with Flask)
+- **Deployment:** GitHub Actions + Render (suggested)
 
-2.  **Start developing.**
+---
 
-    Navigate into your new site’s directory and start it up.
+## 🚀 Getting Started (Local Setup)
 
-    ```shell
-    cd my-gatsby-site/
-    npm run develop
-    ```
+### 1. Clone this repository
 
-3.  **Open the code and start customizing!**
+```bash
+git clone https://github.com/YOUR_USERNAME/portfolio-template.git
+cd portfolio-template
+```
 
-    Your site is now running at http://localhost:8000!
+### 2. Set up virtual environment
 
-    Edit `src/pages/index.tsx` to see your site update in real-time!
+```bash
+python -m venv venv
+source venv/bin/activate   # Windows: venv\Scripts\activate
+```
 
-4.  **Learn more**
+### 3. Install dependencies
 
-    - [Documentation](https://www.gatsbyjs.com/docs/?utm_source=starter&utm_medium=readme&utm_campaign=minimal-starter-ts)
-    - [Tutorials](https://www.gatsbyjs.com/tutorial/?utm_source=starter&utm_medium=readme&utm_campaign=minimal-starter-ts)
-    - [Guides](https://www.gatsbyjs.com/tutorial/?utm_source=starter&utm_medium=readme&utm_campaign=minimal-starter-ts)
-    - [API Reference](https://www.gatsbyjs.com/docs/api-reference/?utm_source=starter&utm_medium=readme&utm_campaign=minimal-starter-ts)
-    - [Plugin Library](https://www.gatsbyjs.com/plugins?utm_source=starter&utm_medium=readme&utm_campaign=minimal-starter-ts)
-    - [Cheat Sheet](https://www.gatsbyjs.com/docs/cheat-sheet/?utm_source=starter&utm_medium=readme&utm_campaign=minimal-starter-ts)
+```bash
+pip install -r requirements.txt
+```
 
-## 🚀 Quick start (Netlify)
+### 4. Environment variables
 
-Deploy this starter with one click on [Netlify](https://app.netlify.com/signup):
+Create a `.env` file in the root directory:
 
-[<img src="https://www.netlify.com/img/deploy/button.svg" alt="Deploy to Netlify" />](https://app.netlify.com/start/deploy?repository=https://github.com/gatsbyjs/gatsby-starter-minimal-ts)
+```env
+FLASK_APP=run.py
+FLASK_ENV=development
+SECRET_KEY=your_secret_key
+SQLALCHEMY_DATABASE_URI=postgresql://username:password@localhost:5432/dbname
+```
+
+> Replace `username`, `password`, `localhost`, `5432`, and `dbname` with your PostgreSQL credentials.
+
+---
+
+### 5. Initialize database
+
+Ensure PostgreSQL is running and the database exists, then run:
+
+```bash
+flask db init          # Only the first time
+flask db migrate -m "Initial migration"
+flask db upgrade
+```
+
+---
+
+### 6. Run the application
+
+```bash
+flask run
+```
+
+---
+
+## 📦 Deployment
+
+### Hosting Options:
+
+- ✅ **Render** – great for Flask apps with PostgreSQL support and simple CI/CD.
+- [ ] Railway
+- [ ] Fly.io
+
+### Render Deployment Steps:
+
+1. Push code to GitHub.
+2. Go to [Render](https://render.com/).
+3. Create a new **Web Service**:
+   - Connect to your GitHub repo.
+   - Use build command: `pip install -r requirements.txt`
+   - Use start command: `gunicorn run:app`
+4. Add environment variables via Render dashboard:
+   - `FLASK_ENV=production`
+   - `SECRET_KEY=your_secret`
+   - `SQLALCHEMY_DATABASE_URI=postgresql://...` *(your Render PostgreSQL connection string)*
+
+---
+
+## 📄 Project Overview
+
+> I am going to develop a web application. It is more like a practice project, but I will also use it as a personal portfolio builder.
+
+This is a portfolio landing page builder:
+- Users can register and login.
+- They get their own dashboard to update profile info.
+- A public shareable link is generated for each profile.
+
+---
+
+## 👨‍💻 Author
+
+Built by Md Abdullah. This is part of my personal portfolio and learning path as a developer.

README.md

@@ -0,0 +1,27 @@
+from flask import Flask
+from app.routes import main
+from config import Config  # Import your config class
+from flask_sqlalchemy import SQLAlchemy
+from flask_migrate import Migrate
+from dotenv import load_dotenv
+import os
+
+# Load environment variables from .env file (in dev only)
+load_dotenv()
+
+# Initialize extensions
+db = SQLAlchemy()
+migrate = Migrate()
+
+def create_app():
+    app = Flask(__name__)
+    app.config.from_object(Config)
+
+    # Register blueprints
+    app.register_blueprint(main)
+
+    # Initialize extensions with app
+    db.init_app(app)
+    migrate.init_app(app, db)
+
+    return app

app/__init__.py

@@ -0,0 +1,7 @@
+from flask import Blueprint, render_template
+
+main = Blueprint('main', __name__)
+
+@main.route('/')
+def index():
+    return render_template('index.html')

app/forms.py

@@ -0,0 +1,9 @@
+<!DOCTYPE html>
+<html>
+<head>
+    <title>Test</title>
+</head>
+<body>
+    <h1>Hello, Flask is working!</h1>
+</body>
+</html>