Power your agent
การติดตั้งจากผู้เผยแพร่ ไม่ใช่เอนด์พอยต์ของ PlugMCP
URL แบบรีโมตหรือคำสั่งบนเครื่องของคุณ? การติดตั้งสองแบบต่างกันอย่างไร
รันบน PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
เปิดจากผู้เผยแพร่
A nextjs portfolio template with a real backend, an AI agent API, and a motion engine that measures animation instead of guessing at it.
Almost every portfolio template is a static page with a JSON file of your jobs. It looks fine until someone asks "can I add a case study?" and you discover the project grid is hardcoded in a component.
Folio Motion is built the other way round:
You need Node.js 20.9 or newer. That's the only
requirement — no .env file, no database setup, no API keys.
# 1. Fork it on GitHub (the Fork button, top right), then:
git clone https://github.com/YOUR-USERNAME/Folio-Motion.git
cd Folio-Motion
npm install
npm run dev
Open http://localhost:3000. Done.
The database starts automatically in memory. If you want it to persist between restarts, see Database.
Everything below happens in src/config/portfolio.ts. That is the only file
you need to touch to have a complete, personal portfolio.
export const personal = {
name: "Aniruddha Adak",
shortName: "Aniruddha",
role: "Full-Stack Developer",
tagline: "I build fast, accessible interfaces and measure how they move.",
// Rotates in the hero, one phrase at a time.
rotatingRoles: ["Full-Stack Developer", "Interface Engineer"],
// Your photo. Put a file in public/images/ and point at it.
avatar: "/images/avatar.svg",
portrait: "/images/portrait.svg",
location: "Kolkata, India",
email: "[email protected]",
// Shows a green "open to work" dot in the hero.
availableForWork: true,
// Link to a PDF in public/. Set to null to hide the button.
resume: null,
};
The template ships illustrated placeholders so nothing ever looks broken.
# Drop your own photo in (a square-ish 4:5 crop works best)
cp ~/Pictures/me.jpg public/images/avatar.jpg
Then change one line:
avatar: "/images/avatar.jpg",
portrait: "/images/avatar.jpg", // or a different photo
Nothing else. No import, no sizing, no config — the component already handles cropping, borders and the caption.
Using a photo from a URL instead? Add the host to
images.remotePatternsinnext.config.ts.images.unsplash.comis already allowed.
// One or two sentences. Used on the home page.
shortBio: "I design and build web products end to end...",
// Longer version. Each array entry becomes a paragraph on /about.
longBio: [
"First paragraph.",
"Second paragraph.",
"Third paragraph.",
],
Add an entry, and a page is created for it automatically — including the URL, the sitemap entry, and the meta description.
export const projects: Project[] = [
{
slug: "my-app", // → /projects/my-app
title: "My App",
summary: "One line for the card.",
description: [
"A paragraph for the case study page.",
"Another paragraph.",
],
image: "/images/projects/my-app.svg", // or .jpg / .png
tech: ["Next.js", "TypeScript", "Postgres"],
year: "2026",
status: "live", // live | building | archived
featured: true, // bigger, at the top of the home page
links: {
live: "https://my-app.com",
repo: "https://github.com/you/my-app",
},
highlights: ["What made it interesting", "Another point"],
proudest: "The part you're happiest to talk about.",
},
];
Want project screenshots? Just use an image file:
image: "/images/projects/my-app.png",
Any format next/image handles: .png, .jpg, .webp, .avif, .svg.
Grouped by category, with a level from 0–100. Set them honestly — this is a portfolio, and an inflated bar helps nobody.
export const skillGroups: SkillGroup[] = [
{
title: "Languages",
icon: Code2, // any icon from lucide-react
skills: [
{ name: "TypeScript", level: 92, note: "Daily driver" },
{ name: "Python", level: 78 },
],
},
];
export const experience: ExperienceEntry[] = [
{
role: "Senior Engineer",
company: "Acme",
period: "2024 - Present",
location: "Remote",
summary: "One or two sentences on the role.",
highlights: [
"A specific thing you did, with a number in it",
"Another, ideally measurable",
],
tech: ["Next.js", "TypeScript"],
status: "current", // highlights the entry in the timeline
},
];
export const socials = [
{ label: "GitHub", href: "https://github.com/you", primary: true },
{ label: "LinkedIn", href: "https://linkedin.com/in/you", primary: true },
{ label: "Email", href: "mailto:[email protected]" },
];
Any href starting with http opens in a new tab automatically. The icon comes
from the label; for anything not in the built-in map it falls back to the text.
Three themes ship with the template — Bench (default), Ink and Paper — switchable from the header. The choice is remembered.
To add your own, copy a block in src/app/globals.css:
:root[data-theme="ocean"] {
--color-paper: #0d1b2a;
--color-paper-2: #11243a;
--color-ink: #e0f2fe;
--color-ink-2: #b6d6ee;
--color-ink-3: #6f93ad;
--color-signal: #38bdf8;
--color-signal-2: #0ea5e9;
--color-signal-ink: #04121d;
--color-ruby: #f87171;
--color-cobalt: #7dd3fc;
--color-violet: #a78bfa;
--color-line: color-mix(in oklab, #e0f2fe 20%, transparent);
--color-line-soft: color-mix(in oklab, #e0f2fe 11%, transparent);
--color-grid: color-mix(in oklab, #e0f2fe 7%, transparent);
--color-panel: color-mix(in oklab, #0d1b2a 92%, #e0f2fe);
--shadow-bench: 0 14px 34px -18px rgba(0, 0, 0, 0.8);
color-scheme: dark;
}
Then add it to the switcher:
// src/components/theme-switcher.tsx
{ id: "ocean", label: "Ocean", swatch: ["#0d1b2a", "#e0f2fe", "#38bdf8"] },
That's it. Every button, border, panel and shadow follows.
The home page is an ordered list. Delete a line to drop a section:
// src/app/page.tsx
export default function HomePage() {
return (
<>
<Hero /> {/* keep */}
<About /> {/* keep */}
<Services /> {/* delete this line to remove "What I do" */}
<Skills />
<FeaturedWork />
<Experience />
<LabTeaser /> {/* the motion lab band */}
<Contact />
</>
);
}
Reorder them by moving lines. There is no config flag for this on purpose — the file is the config.
Project pages are prerendered at build time from your config, so they're fast and indexable.
Out of the box the form validates correctly and then tells you, honestly, that
email delivery is not configured — and offers a mailto: link so the visitor is
never stuck at a dead end. It never pretends to have sent a message.
To make it actually send, add one environment variable on Vercel:
Then deploy. The form starts sending immediately — no code change.
Open src/app/api/contact/route.ts and replace the sendEmail() function with
your provider's HTTP call. It receives a validated object and returns
{ ok: true } or { ok: false, error }. Nothing else needs to change.
You do not need one. Without configuration the app uses an embedded PGlite
Postgres that starts with the process, so npm run dev and a fresh Vercel
deploy both work immediately.
If you want data to survive between deploys, install Neon (or any Postgres) and set one variable:
The app refuses to start in production without a connection string rather than silently losing your data on the next cold start. That is deliberate.
Schema and indexes are created automatically on first run. There is no migration step to forget.
This is the part that makes the template worth having.
Animation is usually chosen by feel. Drag the damping dial down and this
lab tells you what you just built: it settles in 1246ms instead of 371ms,
overshoots by 47%, and scores 31/100 with the reason next to every number.
Nothing is a lookup table. src/lib/engine.ts integrates
x'' = (−k·x − c·v) / m
with a fixed-step symplectic Euler solver at 240Hz, and solves cubic beziers the same way a browser does. The preview box is moved by that same integration, which is why the curve, the animation and the score always agree.
The bug worth knowing about. The obvious way to detect rest — "close enough to the target" — is wrong. An under-damped spring passes through the target at speed several times before it stops, so that approach reports zero overshoot for violently bouncing motion. This repo requires a velocity condition as well, and ships a regression test for it.
From here you can export production-ready CSS, a Framer Motion module, an SVG of the real curve, or a Markdown report.
The agent console exposes the same engine over MCP, so an AI can compare curves and write specs for you.
src/
├── config/
│ └── portfolio.ts ← YOUR CONTENT. Edit this.
├── app/
│ ├── page.tsx ← home page = an ordered list of sections
│ ├── about/ ← /about
│ ├── projects/ ← /projects and /projects/[slug]
│ ├── experience/ ← /experience
│ ├── contact/ ← /contact
│ ├── lab/ method/ agent/ verify/ ← the motion lab
│ └── api/ ← REST + MCP endpoints
├── components/
│ ├── sections/ ← hero, about, projects, experience, contact
│ ├── motion-primitives.tsx ← every animation on the site
│ ├── live-spring-preview.tsx ← the physics-driven box
│ ├── curve-chart.tsx ← the measured curve
│ ├── score-meter.tsx ← the explainable score
│ ├── theme-switcher.tsx ← three palettes
│ └── site-header.tsx site-footer.tsx
└── lib/
├── engine.ts ← the physics. Pure, tested, deterministic.
├── integrity.ts ← SHA-384 audit chain
├── repository.ts ← all SQL
├── service.ts ← one code path for every mutation
└── feed.ts ← live npm registry data
public/images/ ← your photo and project covers
tests/ ← 76 unit tests
e2e/ ← 42 browser tests (desktop + mobile)
Deploying to Vercel needs nothing. Other platforms work too; it's a standard Next.js app.
Not a checkbox — it's in the build.
prefers-reduced-motion.aria-describedby.aria-label describing the measurement.// src/app/layout.tsx
import { Inter, Space_Grotesk, JetBrains_Mono } from "next/font/google";
const display = Space_Grotesk({ subsets: ["latin"], variable: "--font-bricolage" });
Then update the three --font-* variables in the @theme block of
globals.css to point at your variable names. Or skip next/font and use any
CSS font stack.
Create src/app/my-page/page.tsx:
import type { Metadata } from "next";
import { PageHeader } from "@/components/page-header";
export const metadata: Metadata = { title: "My page" };
export default function MyPage() {
return (
<>
<PageHeader eyebrow="Section" title="My page" lede="A sentence about it." />
<section className="mx-auto max-w-3xl px-4 py-16">…</section>
</>
);
}
Then add { label: "My page", href: "/my-page" } to navigation.
Everything is in src/components/sections/. Swap the file's contents and keep
the same export name and the home page keeps working.
Delete src/app/lab/, src/app/method/, src/app/agent/, src/app/verify/,
src/app/signals/, and the lab's API routes. Then remove <LabTeaser /> from
src/app/page.tsx and the Motion Lab entry from navigation. The portfolio
does not depend on any of it.
It all comes from seo in src/config/portfolio.ts — the title, description,
keywords, and the siteUrl used for canonical URLs and the sitemap. Set
siteUrl to your real domain before you launch.
Vercel (easiest): push to GitHub and import the repo. Add
RESEND_API_KEY if you want the contact form to send. Done.
Anywhere else: it's a standard Next.js app.
npm run build
npm start
Issues and pull requests are welcome. Read
CONTRIBUTING.md first — the project has a few conventions
worth knowing before you touch the engine.
Security reports: SECURITY.md. Please don't open a public
issue for a vulnerability.
MIT © 2026 Aniruddha Adak
Fork it, make it yours. If you build something good with it, a star is a nice way to say thanks.
A production-grade portfolio template with a real backend, an AI agent API, and a motion engine that measures animation instead of guessing. One config file to make it yours. Next.js 16, React 19, Tai
ภาพรวม
A production-grade portfolio template with a real backend, an AI agent API, and a motion engine that measures animation instead of guessing. One config file to make it yours. Next.js 16, React 19, Tailwind 4, 0 vulnerabilities.
เครื่องมือ
ยังไม่มีรายการเครื่องมือ เซิร์ฟเวอร์แบบรีโมตจะได้รายการหลังการตรวจสอบสถานะครั้งแรก
FAQ
คัดลอกคอนฟิก stdio สำหรับ Cursor, Claude Desktop, Claude Code หรือ VS Code ได้ในหน้านี้ คอนฟิกนี้ใช้การติดตั้งของผู้เผยแพร่ ไม่ใช่พร็อกซีของ PlugMCP
ระเบียนนี้ไม่ได้ระบุตัวแปรสภาพแวดล้อมที่จำเป็น
Folio Motion ทำงานแบบโลคัลผ่าน stdio
ตรวจสอบล่าสุดเมื่อ 2026-10-28 A production-grade portfolio template with a real backend, an AI agent API, and a motion engine that measures animation instead of guessing. One config file to make it yours. Next.js 16, React 19, Tailwind 4, 0 vulnerabilities.