Skip to content

ck-ahmad/Portfolio

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

39 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🌌 Ahmad Leo's Portfolio Website

Built with Flask β€’ Flask-Mail β€’ HTML β€’ CSS β€’ JavaScript


πŸš€ Overview

A professional portfolio website crafted using Python Flask and designed to highlight my:

  • πŸ“Œ Technical skills & achievements
  • πŸŽ“ Educational background
  • πŸ’» Projects with smooth animations
  • πŸ“¬ Real-time contact form using Flask-Mail

Responsive, clean, and completely customizable β€” with dark mode vibes!


πŸ”₯ Features

  • βœ… Fully responsive UI with AOS scroll animations
  • βœ… Real contact form using Flask-Mail (SMTP support)
  • βœ… Projects, education, and certification showcase
  • βœ… All files in a single folder structure for easy deployment
  • βœ… Dark starry background and modern layout

πŸ› οΈ Tech Stack

Layer Technology
Backend Python, Flask, Flask-Mail
Frontend HTML5, CSS3, JavaScript
Email Flask-Mail, Gmail SMTP
Animation AOS (Animate On Scroll)
Deployment Render / Vercel / Heroku / PythonAnywhere

πŸ“ Folder Structure

portfolio-website/
β”‚
β”œβ”€β”€ static/                # All CSS, JS, images
β”‚   β”œβ”€β”€ style.css
β”‚   β”œβ”€β”€ script.js
β”‚   └── images/
β”‚
β”œβ”€β”€ templates/             # HTML pages
β”‚   β”œβ”€β”€ index.html
β”‚   └── about.html / others
β”‚
β”œβ”€β”€ app.py                 # Main Flask backend
β”œβ”€β”€ requirements.txt       # Python packages
└── README.md              # This file

βš™οΈ Setup Instructions

πŸ“₯ 1. Clone the Repository

git clone https://github.com/ck-ahmad/portfolio-website.git
cd portfolio-website

πŸ§ͺ 2. (Optional) Create Virtual Environment

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

πŸ“¦ 3. Install Dependencies

pip install -r requirements.txt

βœ‰οΈ 4. Configure Email in app.py

Replace the following with your credentials:

app.config['MAIL_SERVER'] = 'smtp.gmail.com'
app.config['MAIL_PORT'] = 465
app.config['MAIL_USERNAME'] = 'your-email@gmail.com'
app.config['MAIL_PASSWORD'] = 'your-app-password'
app.config['MAIL_USE_TLS'] = False
app.config['MAIL_USE_SSL'] = True

πŸ” Use Gmail App Password, not your real password.

🧠 5. Run the Application

python app.py

Then visit http://127.0.0.1:5000 in your browser.


πŸ“Έ Preview

Portfolio Screenshot

🌐 Live Demo

πŸ”— Watch Video Demo



πŸ”— Visit Live Site

πŸͺͺ License

Licensed under the MIT License. Feel free to fork, use, and improve!


πŸ™‹β€β™‚οΈ Contact

You can reach me through the contact form on the site or via the links in my GitHub Bio.


⭐ Support

If you like this project, give it a ⭐ on GitHub and share it!


---

### βœ… Let me know if you want:

- A `requirements.txt` generated from your current setup
- GitHub README badges for certifications
- Deployment guide for Render, Heroku, or PythonAnywhere
- A custom banner or screenshot section added

Would you like me to generate the `requirements.txt` and add it here too?

About

πŸš€ Passionate Python Developer | Flask & AI Enthusiast Welcome to my portfolio! I build intelligent web apps using Flask, Python, and speech recognition. Skilled in backend APIs, voice interfaces, and clean UI with HTML/CSS/JS.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors