👑 Pharaohfolio

Simple hosting for single-page portfolios — by Imhotep Tech

The easiest way to host your AI-generated portfolio — no technical skills required

Generate your portfolio with ChatGPT, Claude, or any AI assistant → Paste the code → Get your live link instantly!

🚀 Quick Start • ✨ Features • 🛠️ Tech Stack • 📱 Demo • 🤝 Contributing

---

✨ Features

🤖 AI-Generated Code Support - Works with any AI assistant (ChatGPT, Claude, Gemini, etc.)
📋 Simple Paste & Deploy - Just paste your HTML/CSS/JS code and get a live link
🌐 Instant Hosting - Your portfolio goes live at pharaohfolio.vercel.app/u/username immediately
💻 Built-in Code Editor - Monaco editor for quick tweaks and customizations
👁️ Live Preview - See your portfolio in real-time as you edit
🔐 Secure Authentication - Email/password and Google OAuth for account management
📱 Mobile-Optimized - All hosted portfolios work perfectly on mobile devices
🛡️ Safe Code Execution - HTML/CSS/JS sanitization to prevent malicious code
📊 Simple Analytics - Basic visit tracking for your portfolio
⚡ Lightning Fast - Instant deployment with global CDN delivery

🛠️ Tech Stack

Backend

• Django REST Framework - Robust API for code storage and deployment
• PostgreSQL - Reliable storage for user accounts and portfolio code
• JWT Authentication - Secure token-based authentication
• Code Sanitization - Security layer to clean HTML/CSS/JS
• Docker - Containerized development and deployment

Frontend

• React 19 - Modern component-based UI
• Vite - Lightning-fast development server
• Tailwind CSS - Beautiful, responsive design
• Monaco Editor - Professional code editing experience
• React Router - Smooth navigation between pages

Infrastructure

• Docker Compose - Multi-container orchestration
• Nginx - Production web server (planned)
• CDN Integration - Fast global content delivery (planned)

📱 How It Works

🤖 Step 1: Generate with AI

Ask any AI assistant like ChatGPT:

"Create me a portfolio website for a web developer with HTML, CSS, and JavaScript. Include sections for about me, projects, and contact."

📋 Step 2: Paste Your Code

Copy the generated HTML, CSS, and JavaScript code and paste it into Pharaohfolio's editor.

🚀 Step 3: Get Your Link

Hit "Deploy" and get your instant live link: pharaohfolio.vercel.app/u/yourusername

✨ Step 4: Share & Shine

Share your professional portfolio with clients, employers, or friends!

---

🎯 Perfect For

• 🎨 Artists & Designers - Showcase your creative work without coding
• 💼 Freelancers - Professional portfolios that convert clients
• 🎓 Students - Academic projects and resume portfolios
• 🚀 Entrepreneurs - Quick business and startup showcases
• 📝 Writers & Bloggers - Content portfolios and personal brands
• 👩‍💻 Anyone - Who wants a professional web presence without the hassle

---

🚀 Quick Start for Contributors

Get the hosting platform running in less than 2 minutes! 🚀

🔧 Prerequisites

• 🐳 Docker & Docker Compose - Install Docker
• 📦 Git - Install Git

⚡ Setup (One Command!)

1. Clone & Navigate

git clone https://github.com/your-username/Pharaohfolio.git
cd Pharaohfolio

2. Set Up Environment Variables 🔑 Create environment files for both backend and frontend:

# Backend environment setup
cd backend/Pharaohfolio
cat > .env << 'EOF'
DEBUG=True
SECRET_KEY='+)#=j8tkch25z^on!=567&^6eyqyn9fgg3mbzypay+g^18vh)5'

# Google OAuth Configuration (Optional - for Google login)
GOOGLE_CLIENT_ID='your_google_client_id_here'
GOOGLE_CLIENT_SECRET='your_google_client_secret_here'
GOOGLE_REDIRECT_URI='http://localhost:8000/api/auth/google/callback/'

# Email Configuration (Optional - for notifications)
MAIL_PASSWORD='your_app_password_here'

# Database Configuration (Docker)
DATABASE_NAME='pharaohfolio_db'
DATABASE_USER='pharaohfolio_user'
DATABASE_PASSWORD='pharaohfolio_password'
DATABASE_HOST='db'

# Optional AI Integration (for future AI features)
GEMINI_API_KEY_1='your_gemini_api_key_here'
GEMINI_API_KEY_2='your_second_gemini_api_key_here'
EOF

# Frontend environment setup
cd ../../frontend/Pharaohfolio
cat > .env << 'EOF'
# Frontend Environment Variables
VITE_API_URL=http://localhost:8000
EOF

# Return to project root
cd ../..

3. Launch the Platform ✨

docker compose up --build

That's it! 🎉 Your portfolio hosting platform is ready!

🎯 What This Does

✅ Database Setup - PostgreSQL container (port 5432)
✅ Backend API - Django REST API (http://localhost:8000)
✅ Frontend App - React application (http://localhost:3000)
✅ Code Editor - Monaco editor for HTML/CSS/JS
✅ Admin Panel - Django admin with demo credentials
✅ Auto-Migration - Database schema setup
✅ Hot Reload - Live code changes during development

🌐 Access Points

Service	URL	Description
🎨 Frontend	http://localhost:3000	Main portfolio hosting interface
⚡ Backend API	http://localhost:8000	REST API endpoints
🔧 Django Admin	http://localhost:8000/admin/	Admin panel (admin/admin123)
🗄️ Database	localhost:5432	PostgreSQL instance

---

🔧 Manual Setup (Alternative)

Prefer hands-on control? Follow these detailed steps!

📋 Prerequisites for Manual Setup

• 🐍 Python 3.11+ - Download Python
• 📦 Node.js 20+ - Download Node.js
• 🗄️ PostgreSQL 15+ - Install PostgreSQL
• 📦 Git - Install Git

📝 Step-by-Step Manual Setup

1️⃣ Clone the Repository

git clone https://github.com/your-username/Pharaohfolio.git
cd Pharaohfolio

2️⃣ Set Up PostgreSQL Database

# 🚀 Start PostgreSQL service
sudo systemctl start postgresql  # Linux
# or
brew services start postgresql   # macOS

# 🗄️ Create database and user
sudo -u postgres psql
CREATE DATABASE pharaohfolio_db;
CREATE USER pharaohfolio_user WITH PASSWORD 'pharaohfolio_password';
GRANT ALL PRIVILEGES ON DATABASE pharaohfolio_db TO pharaohfolio_user;
\q

3️⃣ Set Up Backend (Django)

# 📂 Navigate to backend directory
cd backend/Pharaohfolio

# 🐍 Create virtual environment
python -m venv venv

# ⚡ Activate virtual environment
source venv/bin/activate  # Linux/macOS
# or
venv\Scripts\activate     # Windows

# 📦 Install dependencies
pip install -r requirements.txt

# 🔄 Create environment variables (.env file)
# Copy the .env content from Step 2 above, but change DATABASE_HOST to 'localhost'

# 🗄️ Run migrations
python manage.py makemigrations accounts
python manage.py makemigrations portfolio
python manage.py makemigrations
python manage.py migrate

# 👤 Create superuser
python manage.py createsuperuser

# 🚀 Start development server
python manage.py runserver

4️⃣ Set Up Frontend (React)

# 🆕 Open new terminal and navigate to frontend directory
cd frontend/Pharaohfolio

# 📦 Install dependencies
npm install

# 🌐 Create environment variables (.env file)
echo "VITE_API_URL=http://localhost:8000" > .env

# 🚀 Start development server
npm run dev

5️⃣ Access the Application

Service	URL	Status
🎨 Frontend	http://localhost:3000	✅ Ready
⚡ Backend API	http://localhost:8000	✅ Ready
🔧 Django Admin	http://localhost:8000/admin	✅ Ready

---

⚙️ Development

🔧 Development Mode Features:

• 🔄 Hot reloading for both frontend and backend
• 📁 Volume mounting for live code changes
• 🐛 Debug mode enabled
• 🎨 Live CSS updates with Tailwind
• ⚡ Fast refresh in React
• 💻 Code editor testing with Monaco integration

🛑 Stop the application:

docker compose down

📜 View logs:

docker compose logs -f

🔄 Rebuild after dependency changes:

docker compose up --build

---

🚨 Troubleshooting

🔌 Port Conflicts

Issue: "address already in use" errors

💡 Solution:

# Check what's using the ports
sudo lsof -i :3000  # Frontend port
sudo lsof -i :8000  # Backend port  
sudo lsof -i :5432  # Database port

# Stop conflicting services
sudo systemctl stop postgresql  # Linux
brew services stop postgresql   # macOS

🛠️ Manual Setup Issues

Problem	Solution
🗄️ Database connection failed	Verify PostgreSQL is running & credentials are correct
🐍 Python import errors	Ensure virtual environment is activated
📦 Node.js version issues	Update to Node.js 20+
🔐 Permission denied	Check file permissions and user access

🐳 Docker Setup Issues

Problem	Solution
🚀 Container build fails	Run docker system prune -a and retry
🗄️ Database connection timeout	Wait for health check to complete
📱 Frontend not loading	Check if port 3000 is available
⚡ Hot reload not working	Restart container with docker compose restart
🔧 API calls failing	Verify frontend .env has VITE_API_URL=http://localhost:8000

---

🤝 Contributing

We welcome contributions from developers who want to help make portfolio hosting accessible to everyone!

🎯 How to Contribute

1. 🍴 Fork the repository
2. 🌟 Create a feature branch (git checkout -b feature/awesome-hosting-feature)
3. 📝 Commit your changes (git commit -m 'Add awesome hosting feature')
4. 📤 Push to the branch (git push origin feature/awesome-hosting-feature)
5. 🔄 Open a Pull Request

🐛 Found a Bug?

Open an issue with:

• 📝 Clear description
• 🔄 Steps to reproduce
• 💻 System information
• 📸 Screenshots (if applicable)

💡 Have an Idea?

We'd love to hear it! Open an issue with the enhancement label.

🎨 Areas for Contribution

• Code Security - Better HTML/CSS/JS sanitization
• Performance - Faster deployment and hosting
• UI/UX - Better code editor experience
• Templates - Pre-built portfolio templates
• Analytics - Enhanced visitor tracking
• Mobile - Mobile app development

---

🌟 Why Pharaohfolio?

The Problem: Most people can easily get beautiful portfolio code from AI assistants like ChatGPT, but they have no idea how to host it online.

Our Solution: Pharaohfolio bridges that gap. Simply paste your AI-generated code and get an instant, live portfolio link. No servers, no deployment headaches, no technical knowledge required.

Perfect for:

• 🎨 Non-technical creators who want professional web presence
• ⚡ Quick deployment of AI-generated portfolios
• 💰 Cost-effective hosting without monthly fees
• 🔧 Simple maintenance - just update your code anytime
• 📱 Mobile-ready portfolios that work everywhere

---

📄 License

This project is licensed under a Custom License. Commercial use of this software is prohibited without prior written permission from Imhotep Tech. For more details, see the LICENSE file.

To request permission for commercial use, contact us at imhoteptech@outlook.com.

🌟 Show Your Support

If you find Pharaohfolio helpful, please consider:

• ⭐ Starring this repository
• 🍴 Forking to contribute
• 🐛 Reporting issues
• 💡 Suggesting new features
• 📱 Sharing with non-technical friends who need portfolios

---

Made with ❤️ by Imhotep Tech

Democratizing web hosting, one portfolio at a time! 👑✨

⬆ Back to Top