Overview

create-foliofy is a CLI tool that generates polished, production-ready developer portfolio sites from a single command. Choose between two curated themes, customize your data in one file, and deploy immediately — no build configuration required.

Features

• Rapid scaffolding — generate a complete portfolio in under two seconds
• Two curated themes — Dark and White visual styles
• Responsive design — optimized for all screen sizes
• Fluid animations — powered by Framer Motion
• Single-file configuration — edit one data file to update the entire portfolio
• Zero configuration — no build tooling or boilerplate setup needed

Quick Start

1. Install globally

npm install -g create-foliofy

2. Scaffold your portfolio

npx create-foliofy@latest

The CLI prompts you through the following options:

| Prompt | Default | |--------|---------| | Project name | my-portfolio | | Theme (white / dark) | white | | TypeScript | Yes | | Git initialization | Yes | | Dependency installation | Yes |

3. Launch

cd my-portfolio
npm run dev

Open http://localhost:3000.

Edit app/data/portfolio.ts to customize your portfolio.

Alternative: One-liner

npx create-foliofy@latest my-portfolio && cd my-portfolio && npm run dev

Non-interactive mode

Skip prompts entirely with flags:

npx create-foliofy@latest my-portfolio --theme dark --yes
npx create-foliofy@latest my-portfolio --theme dark --no-install --git

| Flag | Alias | Description | |------|-------|-------------| | --theme | -t | Theme selection (white or dark) | | --yes | -y | Skip all prompts, use defaults | | --no-install | | Skip dependency installation | | --no-git | | Skip git initialization | | --no-ts | | Skip TypeScript | | --dry-run | | Preview without writing files |

Themes

| Theme | Command | |--------|---------| | Dark | npx create-foliofy@latest my-portfolio --theme dark | | White | npx create-foliofy@latest my-portfolio --theme white |

Portfolio Preview

White theme portfolio featuring hero, projects, and skills sections.

Usage

Interactive Mode

npx create-foliofy@latest my-portfolio

Follow the prompts to select your preferred theme.

Non-Interactive Mode

npx create-foliofy@latest my-portfolio --theme dark --yes

Options

| Flag | Alias | Description | |----------|-------|------------------------------| | --theme| -t | Theme selection (dark/white) | | --yes | -y | Skip prompts, use defaults |

Technology Stack

| Technology | Purpose | |---------------|-------------------| | Next.js | React framework | | TypeScript | Type safety | | Framer Motion | Animations | | Tailwind CSS | Styling |

Project Structure

my-portfolio/
  app/
    components/     Reusable UI components
    data/           Portfolio data (edit this file)
    globals.css     Global styles
    layout.tsx      Root layout
    page.tsx        Main page
  public/           Static assets
  package.json
  next.config.ts

Customization

Edit app/data/portfolio.ts to update:

• Name, biography, and contact information
• Project showcase
• Skills and technologies
• Experience timeline
• Social links

License

MIT © Shravan Ramakunja