Deneb Jekyll documentation
Create Portfolio
Portfolio projects showcase your work, skills, and achievements. This guide will help you create compelling portfolio entries.
Overview
Portfolio projects showcase your work, skills, and achievements. This guide will help you create compelling portfolio entries.
Directory Structure
- Portfolio projects are stored in the
_portfolio/directory - Use the naming convention:
project-name.md
Portfolio Project File Structure
Filename Example
_portfolio/project-digital-agency-redesign.md
Front Matter Configuration
---
layout: portfolio-details
title: "Digital Agency Redesign"
date: 2025-01-15
category: [web design, branding]
tags: [ui/ux, responsive design]
image: "/assets/images/portfolio/project-1.webp"
client: "TechInnovate Corp"
project_url: "https://example.com"
description: "Complete digital transformation for a leading tech company."
technologies:
- React
- Figma
- AWS
featured: true
weight: 1
---
Front Matter Parameters
layout: Useportfolio-detailstitle: Project namedate: Project completion datecategory: Project type or industrytags: Specific technologies or skillsimage: Project featured imageclient: Client nameproject_url: Live project linkdescription: Project overviewtechnologies: Used tech stackfeatured: Highlight on portfolio pageweight: Sorting order
Project Description Structure
## Project Overview
Detailed description of the project, its goals, and challenges.
### Project Objectives
- Specific goals
- Key performance indicators
### Design Process
1. Research and discovery
2. Wireframing
3. Prototyping
4. Final design
### Technologies Used
- Frontend: React, Tailwind CSS
- Backend: Node.js, Express
- Deployment: AWS, Netlify
### Challenges and Solutions
Describe unique challenges and how they were overcome.
### Results
- Quantifiable outcomes
- Client testimonial
Best Practices
- Use high-quality project images
- Write clear, concise descriptions
- Highlight key achievements
- Include relevant technologies
- Showcase problem-solving skills
- Use consistent formatting
Image Guidelines
- Use professional, high-resolution images
- Optimize for web performance
- Include multiple project screenshots
- Use consistent image sizes
SEO Optimization
- Use descriptive titles
- Include relevant keywords
- Write comprehensive descriptions
- Add alt text to images
Workflow
- Gather project details
- Create a new file in
_portfolio/ - Add front matter
- Write project description
- Include images
- Preview locally
- Publish
Troubleshooting
- Check image paths
- Verify front matter syntax
- Ensure consistent formatting
- Test portfolio page display
Related Guides
- Creating Pages
- Theme Configuration
- Portfolio Page Layout
Next Steps
- Collect your best projects
- Create portfolio entries
- Showcase your professional achievements