Dark Modern Portfolio Website
A modern, dark-themed portfolio website with smooth animations and dynamic GitHub integration. Built with performance and user experience in mind.
โจ Features
๐จ Design
- Dark Modern Theme - Pure black background with neon green accents
- Brutalist Minimalism - Clean, bold typography with strong grid system
- Space Grotesk Typography - Modern geometric font for headings
- Subtle Grid Background - Professional texture without distraction
- Profile Photo Integration - Auto-fetched from GitHub API
๐ฌ Animations & Interactions
- GSAP ScrollTrigger - Smooth scroll-based animations
- Lenis Smooth Scroll - Buttery smooth scrolling experience
- Magnetic Buttons - Interactive hover effects
- Custom Cursor - Enhanced cursor with follower
- Scroll Progress Bar - Visual feedback for page position
- Shimmer Effects - Subtle animations on skill bars and buttons
๐ GitHub Integration
- Dynamic Repository Display - Auto-fetch from GitHub API
- Starred Repositories - Show repos you've starred
- Latest Updates - Display last update time (2d ago, 1w ago, etc.)
- Enhanced Filtering - Filter by All/Starred/Latest/Python/Odoo/Web
- Stars & Forks Count - Show repository statistics
- Project Cards - Modern cards with glow effects on hover
๐ฑ Responsive Design
- Mobile-First Approach - Optimized for all devices
- Breakpoints - 1024px, 768px, 576px, 375px
- Touch-Friendly - Optimized interactions for mobile
- Adaptive Layout - Content reflows beautifully on all screens
๐ง Contact Form
- EmailJS Integration - Serverless email sending
- Form Validation - Client-side validation
- Success Feedback - Beautiful sss message
- Rate Limiting - Prevent spam (1 request per 10 seconds)
๐ Tech Stack
Frontend
โโโ HTML5 (Semantic markup)
โโโ CSS3 (Custom properties, Grid, Flexbox)
โโโ JavaScript (ES6+)
Libraries & Tools
โโโ GSAP 3.12.5 (Animation engine)
โ โโโ ScrollTrigger (Scroll-based animations)
โโโ Lenis 1.3.17 (Smooth scroll)
โโโ EmailJS (Contact form)
โโโ Font Awesome 6.5.1 (Icons)
APIs
โโโ GitHub REST API v3
โ โโโ /users/{username}/repos (Your repositories)
โ โโโ /users/{username}/starred (Starred repositories)
Hosting
โโโ GitHub Pages (Free, fast, reliable)
๐ฆ Installation
1. Clone the Repository
git clone https://github.com/tickernelz/tickernelz.github.io.git
cd tickernelz.github.io
2. Customize Content
Update Personal Information
Edit index.html:
- Change name, title, description in hero section
- Update about section text
- Modify skills and percentages
- Update social media links
Update GitHub Username
Edit js/main.js:
// Line ~250
const username = 'tickernelz'; // Change to your username
Customize Colors
Edit css/style.css:
:root {
--bg-primary: #0a0a0a; /* Background */
--accent-primary: #00ff88; /* Neon green */
--accent-secondary: #ff0055; /* Hot pink */
/* ... */
}
3. EmailJS Setup (Optional)
The contact form uses EmailJS. To set it up:
-
Create account at EmailJS
-
Create email service (Gmail recommended)
-
Create email template with these parameters:
from_name - Sender's name
from_email - Sender's email
subject - Email subject
message - Email message
to_name - Your name
to_email - Your email
reply_to - Sender's email
-
Update credentials in index.html:
// Line ~460
emailjs.init({
publicKey: "YOUR_PUBLIC_KEY",
// ...
});
// Line ~210
emailjs.send('YOUR_SERVICE_ID', 'YOUR_TEMPLATE_ID', templateParams)
4. Deploy to GitHub Pages
git add .
git commit -m "Initial portfolio setup"
git push origin master
Then enable GitHub Pages:
- Go to repository Settings
- Navigate to Pages section
- Select
master branch as source
- Click Save
Your portfolio will be live at https://yourusername.github.io
๐จ Customization Guide
Change Animation Speed
// js/main.js - Line ~3
const lenis = new Lenis({
duration: 1.2, // Change to 1.5 for slower scroll
// ...
});
Adjust Hover Effects
/* css/style.css */
.project-card:hover {
transform: translateY(-8px); /* Adjust lift amount */
box-shadow: var(--shadow-glow);
}
Modify Skill Bars
<!-- index.html -->
<div class="skill-progress" style="width: 90%"></div>
<!-- Change percentage -->
Update Profile Photo
The photo is auto-fetched from GitHub:
<img src="https://github.com/tickernelz.png" alt="Your Name">
<!-- Change username to yours -->
Or use custom photo:
<img src="path/to/your-photo.jpg" alt="Your Name">
๐ฏ Performance Optimizations
- โ
Lazy Loading - Images and animations load on demand
- โ
Efficient Animations - GPU-accelerated transforms
- โ
Debounced Events - Optimized scroll listeners
- โ
Minimal DOM Manipulation - Efficient rendering
- โ
CDN Resources - Fast library loading
- โ
Cached API Responses - Reduced API calls
๐ Browser Support
- โ
Chrome/Edge (latest)
- โ
Firefox (latest)
- โ
Safari (latest)
- โ
Mobile browsers (iOS Safari, Chrome Mobile)
Note: Custom cursor disabled on mobile for better UX.
๐ Troubleshooting
Smooth Scroll Not Working
- Ensure Lenis CDN is loaded correctly
- Check browser console for errors
- Verify
autoRaf: false and manual raf loop
GitHub API Not Loading
- Check username in
js/main.js
- Verify internet connection
- Check browser console for CORS errors
- GitHub API has rate limit (60 requests/hour unauthenticated)
Animations Not Triggering
- Ensure GSAP and ScrollTrigger are loaded
- Check if elements have correct classes
- Verify ScrollTrigger.update() is called
Contact Form Not Sending
- Verify EmailJS credentials
- Check browser console for errors
- Ensure all form fields are filled
- Check EmailJS dashboard for quota
๐ Project Structure
tickernelz.github.io/
โโโ index.html # Main HTML file
โโโ css/
โ โโโ style.css # All styles (1400+ lines)
โโโ js/
โ โโโ main.js # All JavaScript (400+ lines)
โโโ README.md # This file
โโโ robots.txt # SEO configuration
โโโ sitemap.xml # Site map for search engines
๐ Learning Resources
๐ License
MIT License - feel free to use this template for your own portfolio!
๐ Credits
Design & Development: Zhafron Adani Kautsar
Inspiration:
- Obys Agency - Minimal animations
- Basement Studio - Dark theme aesthetics
- Darkroom Engineering - Lenis smooth scroll
Libraries:
- GSAP by GreenSock
- Lenis by Darkroom Engineering
- EmailJS
- Font Awesome
๐ Links
Made with โค๏ธ and lots of โ
Last updated: January 2026