🚀 Advay Portfolio Website

A full-featured developer portfolio and tools hub — self-hostable, CMS-driven, AI-powered.

Your portfolio. Your brand. Your tools. All in one self-hostable app.

---

✨ Features

• 🏠 Dynamic Homepage — Animated hero, 3D rotating stack labels, smooth theme rotation, particle canvas
• 👤 Profile & About — Bio, avatar, skills, social links, specializations — all editable from admin
• 🗂️ GitHub Repos — Public repo showcase with collapsible README previews
• ⚡ Live Tools — Deployed tools grid with category filters
• ⚙️ n8n Templates — Downloadable automation workflow templates showcase
• 🤝 Hire Me Form — Contact form with service categories, quick info sidebar, intro text
• 🤖 AI Chat Assistant — In-page chat powered by Groq (scoped to portfolio context only)
• 💡 Suggestion Box — Floating visitor feedback widget
• 🔧 Admin Dashboard — Hidden CMS at a secret URL — manage everything without touching code
• 🔔 n8n Webhook Notifications — Instant alerts for new contact requests and suggestions
• 💳 License System — One-time activation per deployment
• 📊 Page Views Tracking — Built-in analytics visible from admin dashboard

---

🗂️ Project Structure

Advay-Portfolio-Website/
├── index.js          # Launcher — fetches and starts the core engine
├── package.json      # Launcher dependencies only
├── .env.example      # Environment variable reference
├── version.txt       # Current release version
└── .gitignore

The core application is loaded securely at runtime. This keeps the source lean and the deployment simple.

---

🚀 Quick Start

1. Fork or clone the repo

git clone https://github.com/Advay254/Advay-Portfolio-Website.git
cd Advay-Portfolio-Website

2. Install dependencies

npm install

3. Set up environment variables

cp .env.example .env

Edit .env with your values:

DATABASE_URL=postgresql://postgres:[PASSWORD]@db.[PROJECT-REF].supabase.co:5432/postgres
ADMIN_PATH=your-secret-admin-path
ADMIN_USERNAME=admin
ADMIN_PASSWORD=your-secure-password
JWT_SECRET=your-long-random-secret
GROQ_API_KEY=gsk_xxxxxxxxxxxxxxxxxxxx
GROQ_MODEL=llama-3.3-70b-versatile
SITE_NAME=YourSiteName

4. Run

npm start

Visit http://localhost:3000 — you're live. 🎉

---

🔑 Environment Variables

Variable	Required	Description
DATABASE_URL	✅ Yes	PostgreSQL / Supabase connection string. Get from: Supabase → Project Settings → Database → URI
ADMIN_PATH	✅ Yes	Secret URL path for your admin dashboard. Example: xk9m4a-panel → admin at /xk9m4a-panel
ADMIN_USERNAME	✅ Yes	Admin login username
ADMIN_PASSWORD	✅ Yes	Admin login password — make it strong
JWT_SECRET	✅ Yes	Long random string for session signing. Generate at randomkeygen.com
GROQ_API_KEY	✅ Yes	Powers the AI chat assistant. Get one free at console.groq.com
GROQ_MODEL	Recommended	Groq model name. Default: llama-3.3-70b-versatile
SITE_NAME	Optional	Display name shown in the browser tab
PORT	Auto	Set automatically by Render — do not set manually

---

🗄️ Database Setup (Supabase — Free Tier)

1. Create a free project at supabase.com
2. Go to Project Settings → Database → Connection string → URI
3. Copy the URI and set it as DATABASE_URL in your environment
4. Done — all database tables are created automatically on first run. No SQL needed.

---

🌐 Deploying to Production

Render (recommended)

1. Fork this repo to your GitHub account
2. Go to render.com and create a new Web Service
3. Connect your forked repo
4. Set Build Command: npm install
5. Set Start Command: npm start
6. Add your environment variables under Environment
7. Click Deploy

Render free tier sleeps after 15 minutes of inactivity. Use cron-job.org to ping /health every 10 minutes to keep it awake.

Railway

npm install -g @railway/cli
railway login && railway init && railway up

Add your environment variables in the Railway dashboard under Variables.

Any VPS (Ubuntu/Debian)

curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs
git clone https://github.com/Advay254/Advay-Portfolio-Website.git
cd Advay-Portfolio-Website && npm install
npm install -g pm2
pm2 start index.js --name advay-portfolio
pm2 save && pm2 startup

---

🛠️ How It Works

User deploys Advay Portfolio Website
        ↓
Launcher starts and fetches the core engine securely at runtime
Core engine extracts and installs its own dependencies
        ↓
App starts — all pages and admin dashboard are ready
        ↓
Admin visits /{ADMIN_PATH} and logs in
Sets up profile, tools, repos, settings from the dashboard
        ↓
Visitors browse the portfolio, use the contact form, chat with the AI assistant
        ↓
New contact requests and suggestions fire instant webhook notifications
to your n8n instance — no need to log in to check manually

---

📊 Tech Stack

---

🔄 Updates

Check version.txt for the latest release version. Sync your fork and redeploy on Render to get the latest update automatically.

---

🤝 Contributing

1. Fork the repo
2. Create your branch: git checkout -b feature/your-feature
3. Commit: git commit -m 'Add your feature'
4. Push: git push origin feature/your-feature
5. Open a Pull Request

---

⚠️ Disclaimer

This project is provided for personal use and self-hosting. The author is not responsible for misuse or downtime of third-party services.

---

📄 License

MIT © 2026 Advay — free to use, modify, and distribute.

---

If this saved you time, drop a ⭐ — it helps others find the project.