developerFolio

developerFolio is an open-source, React-based portfolio template that generates a responsive personal website for software developers by editing a single configuration file.

What is developerFolio?

developerFolio is a free, MIT-licensed portfolio template maintained by Saad Pasta and other contributors on GitHub. It takes a developer's resume data, GitHub profile, Medium blog posts, and social links as inputs and produces a multi-section personal portfolio website. The project runs on React (via Create React App) and requires Node.js version 10.16.0 or higher and npm 6.9.0 or higher to run locally. A live example is hosted at https://developerfolio.js.org/.

Key Features

• Configuration-driven content — Edit the src/portfolio.js file to change all text, links, projects, skills, and experience; the theme colors are globally defined in src/_globalColor.scss.
• GitHub integration — Set REACT_APP_GITHUB_TOKEN and GITHUB_USERNAME in a .env file to auto-fill open-source projects (pinned repos) and the GitHub profile section via the GitHub API.
• Medium blog integration — Add MEDIUM_USERNAME to the .env file to fetch and display your latest Medium articles in the Blogs section, toggled by displayMediumBlogs.
• 13 portfolio sections — Includes greeting, skills, education, work experience, open-source projects, big projects, achievements, blogs, talks, podcast, contact, Twitter timeline, and GitHub profile sections.
• Lottie animations — Replace JSON files in src/assets/lottie to change the animated illustrations, and adjust animation options in src/components/displayLottie/DisplayLottie.js using lottie-react.
• Resume download — Drop a PDF named resume.pdf into src/containers/greeting/resume and a download button appears in the greeting section.
• Social media links — Pre-configured fields for GitHub, LinkedIn, Gmail, GitLab, and Facebook in portfolio.js.
• Docker support — Dockerfile included to build and run with docker build -t developerfolio:latest . and docker run -t -p 3000:3000 developerfolio:latest.

Who is it for?

• Software developers who want a personal portfolio without building one from scratch — clone the repo, edit src/portfolio.js, and deploy to GitHub Pages or Netlify.
• Open-source contributors who need to showcase their pinned GitHub repositories and GitHub profile stats automatically via the GitHub API token setup.
• Bloggers and content creators who want to display Medium articles and Twitter activity alongside work experience and projects in a single-page layout.
• Job seekers in tech roles who want a responsive, resume-downloadable site to share with recruiters.

What can you do with developerFolio?

• Customize the entire page content — Replace all placeholder text in src/portfolio.js with your own summary, skills, education, and projects without touching component code.
• Automate project showcase — Connect your GitHub account by setting the token environment variable, and the Open Source Projects section will show your pinned repositories.
• Set up automatic weekly deploys — Configure the included GitHub Actions workflow, which re-deploys your portfolio every week so GitHub changes appear without manual updates.
• Deploy once to multiple hosts — Follow the included instructions to publish on GitHub Pages or link the repo to Netlify for one-click hosting.

How does developerFolio work?

Clone the repository, install dependencies with npm install, and start a local server with npm start. Then edit src/portfolio.js to insert your data, optionally add environment variables (GitHub token, Medium username) in a .env file, and run a build to deploy. The included GitHub Actions workflow can automate re-deploying every week.

Pros and cons

• Pros: Free and open source under MIT; no backend required; rich integration with GitHub, Medium, Twitter; Docker support; many contributors and 6,612 GitHub stars.
• Cons: The repository description notes that the project is currently not being actively maintained; open-source projects only show pinned items from your GitHub profile; some sections depend on external API data that requires environment variables to be set.

Pricing

developerFolio is free and open source under the MIT license. There are no commercial tiers or paid plans.

FAQ

Is developerFolio free?

Yes, developerFolio is released under the MIT license, so you can use, modify, and deploy it for personal or commercial purposes without paying anything. The source code is available on GitHub.

How do I customize the portfolio content?

Open src/portfolio.js in the project root and replace the placeholder objects (greeting, socialMediaLinks, skillsSection, workExperience, etc.) with your own information. To change colors, edit src/_globalColor.scss; to update the site title and SEO metadata, edit index.html.

Do I need a GitHub token?

You need a GitHub personal access token only if you want the Open Source Projects and GitHub Profile sections to load live data from the GitHub API. Create a classic token with no scopes, add it as REACT_APP_GITHUB_TOKEN in your .env file, and set USE_GITHUB_DATA to true.

How do I deploy developerFolio to GitHub Pages?

Edit the homepage field in package.json to your domain, run the build command, and push to GitHub. The repo includes a GitHub Actions workflow that can automate deployment weekly via a cron job.

Is developerFolio still actively maintained?

The GitHub repository description states that it is currently not being actively maintained, though it has accumulated over 6,000 stars and contributions from many developers. You can still fork it and maintain your own version.