Skip to main content

Quick Start

Clone the repo, configure your environment, and have a running portfolio in minutes.

Project Structure

Understand how components, data files, and API routes are organized.

Customization

Update your personal info, skills, projects, and theme to make it yours.

AI Chatbot

Configure the Groq-powered assistant that answers questions about your portfolio.

What is JPN Web Design?

JPN Web Design is a full-featured personal portfolio template with a distinct Japanese wabi-sabi aesthetic. Built on Next.js 16 with the App Router, it combines traditional Japanese visual patterns with a modern development stack.

Japanese Aesthetic

Traditional patterns — seigaiha waves, uroko scales, kumo clouds — rendered in CSS for authentic visual identity.

AI Assistant

An interactive chatbot powered by Groq’s Llama 3.1 model streams answers about your skills, projects, and experience.

Data-Driven

All portfolio content lives in TypeScript data files — update one file and changes propagate throughout the entire site.

Tech stack

LayerTechnology
FrameworkNext.js 16 (App Router + React Compiler)
LanguageTypeScript 5
StylingTailwind CSS 4
AIGroq SDK — Llama 3.1 8B Instant
UI ComponentsRadix UI + shadcn/ui
IconsLucide React
LintingBiome
FontsNoto Sans JP + Noto Serif JP

Portfolio sections

The portfolio ships with five fully-built sections:
  • Hero — Profile image, name, title, and social links
  • Works — Project showcase grid with tags, GitHub links, and live demo URLs
  • Skills — Technology grid organized by category with Japanese labels
  • Experience — Timeline of professional experience and education
  • AI Drawer — Floating chat widget powered by Groq

Get started

1

Clone and install

Clone the repository and install dependencies with pnpm.
2

Add your Groq API key

Create a .env.local file with your GROQ_API_KEY to enable the AI chatbot.
3

Update your content

Edit the files in data/ to replace the placeholder content with your own information.
4

Deploy to Vercel

Push to GitHub and import the repository in Vercel — it deploys automatically.

Start here: Quickstart guide

Follow the step-by-step guide to get your portfolio live in under 10 minutes.

Build docs developers (and LLMs) love