Enju Folio

Enju (槐 🌳 in Japanese) — a symbol of knowledge, longevity, and quiet elegance.

Enju Folio is a minimalist, accessible, and carefully structured academic portfolio template built with Next.js and Tailwind CSS, designed to showcase your research, projects, and publications with clarity and warmth.

🚀 Live Demo · 📚 Documentation

If you enjoy using it, please consider giving it a star ⭐ — I hope Enju Folio can feel like a small home for your work, too.

| |

🚀 Get Started

Ready to launch your own Enju Folio? You have two options:

1. One-click deploy (recommended)

Deploy instantly to Vercel:

This will:

• Clone the repository to your GitHub account
• Create a Vercel project
• Set up build settings for you

After deployment, update src/enju.config.ts to make the site truly yours. And add your content in src/contents.

2. Run locally

Prerequisites

• Node.js >= 20
• pnpm (Corepack or global install)

Clone & start dev server

git clone https://github.com/ZL-Asica/EnjuFolio.git
cd EnjuFolio

pnpm install
pnpm dev

Then open http://localhost:3000 in your browser.

Next, edit:

• src/enju.config.ts — main site & portfolio configuration
• src/contents — MDX content for pages like research, projects, and news

For more details on configuration and structure, see the full docs:

📖 Enju Folio Documentation

✨ Features

• 🧑‍🎓 Academic-first design Built for researchers and students: sections for research, projects, news, and an embedded CV, with MDX-powered content.

• 🧩 Config-driven, not CMS-heavy Most customization lives in a single file: src/enju.config.ts. Set your name, affiliations, social links, metadata, and home layout without touching the internals.

• ♿ Accessible by default Semantic HTML, keyboard-friendly navigation, and thoughtful defaults for typography and contrast.

• 📄 CV-friendly layout Embed a local PDF or a public Google Drive link, with a dedicated /cv page and an “Open PDF” button.

• 🔍 SEO & rich metadata JSON-LD for Person / Organization, sameAs links, Open Graph tags, optional RSS feeds for news / research / projects.

• 🧠 LLM-aware content Optional llms.txt integration to express how you’d like language models to treat your research and portfolio content.

• 🎨 Clean, responsive UI Minimal Tailwind CSS styling, dark-mode friendly, and easy to extend with your own components.

• 🛠️ TypeScript, linted & formatted Ships with TypeScript, ESLint, and Prettier, so you get a consistent, production-ready base out of the box.

🏗️ Project Structure

.
├── public                    # Static assets
│   └── images                # Image resources (avatars, covers, etc.)
├── src                       # Application source code
│   ├── enju.config.ts        # Enju Folio main configuration
│   ├── app                   # Next.js App Router (routes, layouts, pages)
│   ├── components            # Reusable UI components
│   │   ├── common            # Shared/common components
│   │   │   └── layout        # Layout-related components
│   │   └── ...               # Section-specific components
│   ├── hooks                 # Custom React hooks
│   ├── lib                   # Metadata, JSON-LD helpers, utilities
│   ├── contents              # MDX content for pages (research, projects, etc.)
│   └── types.d.ts            # Global type definitions
├── next.config.ts            # Next.js configuration
├── tsconfig.json             # TypeScript configuration
├── eslint.config.mjs         # ESLint configuration
├── package.json              # Scripts & dependencies
└── pnpm-lock.yaml            # pnpm lockfile

❤️ About Enju Folio

After years of juggling fragile themes, plugin conflicts, and performance issues, I wanted something small, understandable, and kind to maintain.

Enju Folio is my answer: a Next.js-based academic portfolio that is:

• Easy to configure for your own name, affiliations, and work
• Strong enough for real-world use
• Minimal enough that you can read through the code and actually understand it

If this template helps you present your work more comfortably, that’s exactly what it’s here for.

🔗 Community & Contributions

Contributions are very welcome — whether it’s bug fixes, documentation improvements, or new ideas.

• 🐛 Found a bug? Please open an issue.
• 💡 Have suggestions? Issues and PRs are both appreciated.
• 🔧 Want to contribute? See the Contribution Guide for details.

If you’re using Enju Folio for your own portfolio, I’d also love to hear about it!