A modern, dark-neutral themed personal portfolio built with Next.js, TypeScript, and Tailwind CSS. This project uses a unified visual system, a reusable component architecture, and a carefully structured codebase designed for clarity, scalability, and maintainability.
This portfolio is designed to be:
- Clean, minimal, and professional
- Consistent in styling across all UI elements
- Easy to scale with reusable component patterns
- Fully theme-ready with a dark-neutral palette
- Developer-friendly, offering clear folder structures and configuration strategies
The project includes a full Tailwind-based component system and supports rapid UI extension.
- Framework: Next.js (App Router)
- Language: TypeScript
- Styling: Tailwind CSS with custom theme extensions
- Icons: Lucide React
- Animation (optional): Framer Motion
- Fonts: Variable fonts through Next.js font optimization
root
├── app/
│ ├── layout.tsx
│ ├── page.tsx
│ ├── components/
│ │ ├── ui/ # Tailwind-based shared UI components
│ │ ├── sections/ # Page sections (Hero, About, Skills, Projects, etc.)
│ │ └── core/ # Layout wrappers, containers, theme helpers
│ └── styles/ # Global CSS
├── public/
├── tailwind.config.js
├── tsconfig.json
├── package.json
└── README.md
A consistent palette used across cards, borders, backgrounds, and typography:
background:#0d0f11surface:#131518surface-light:#1b1e22border:#2a2e33text-primary:#fffffftext-secondary:#c7c9ccaccent:#4f90ff
- Custom colors for dark-neutral UI
- Consistent shadows and rounded radii
- Standard spacing scale for sections
- Reusable animations for hovering and transitions
- A single card style used across every component
- Balanced spacing for readability
- Low contrast but still readable typography
- Zero inline styles; all consistent through classes
The UI is built around atomic, composable, reusable components.
Card– universal card containerSection– consistent top-level page blocksContainer– layout wrapper for max width and paddingHeading– section header typography system
HeroToolsStackProjectsAboutContact
git clone <repository-url>
cd portfolio
npm install
npm run dev
npm run build
npm run start
Most portfolio setups do not require environment variables. Optional fields:
NEXT_PUBLIC_GA_ID=
Found in tailwind.config.js:
- Theme extensions
- Typography defaults
- Custom animations
Editable in app/styles/globals.css:
- Base resets
- Scroll behavior
- Custom utility classes
To keep UI consistency, follow this pattern:
- Use the same base card class:
bg-surface border border-border rounded-xl p-4 shadow-sm - Text always uses
text-primaryortext-secondary - Spacing follows Tailwind’s
py-20for sections - Icons use fixed sizing (
w-5 h-5) - All hover effects are subtle (low-opacity accent borders)
This project deploys seamlessly to:
- Vercel (recommended)
- Netlify
- Cloudflare Pages
vercel deploy
- Add light mode toggle
- Add mini-blog section
- Include animations for section transitions
- Add CMS integration (e.g., Sanity or Contentlayer)
This project is licensed under the MIT License.
Etornam Kordzo Ahiataku (Tornam) Student ~ Software Engineer KNUST