Flexy Dev - Next.js Portfolio Template

✨ Professional Portfolio Template built with Next.js 15 • 🚀 Tailwind V4 • 📱 Fully Responsive • 🎨 Modern Design • 🔍 SEO Friendly

🚀 How to Run the Project

Follow these steps to set up and run the project locally:

1️⃣ Install Dependencies

After downloading/cloning the project, navigate to the project directory and run:

npm install
# or
yarn install

This will install all required dependencies.

2️⃣ Start the Development Server

Once the installation is complete, start the server with:

npm run dev
# or
yarn dev

Your portfolio will now be running at http://localhost:3000.

⚠️ Important: Set Up Environment Variables

Before running the project, make sure to create a .env.local file in the root directory and add the following:

NEXT_PUBLIC_SITE_URL=http://localhost:3000

This ensures proper configuration of environment variables.

Folder Structure Overview

• content: Contains data for projects. Add any additional section data here.
• Components: All the UI components of app e.g. navbar, hero, projects, footer etc
• src/services: Retrieves data (e.g., projects, testimonials) using the fs module. Update this file if you change or modify the data source.
• src/assets: Stores all assets, including images and icons, additionally you can add audio, video, and local fonts here.
• src/hooks: Holds custom hooks.
• src/lib/types.d.ts: Contains TypeScript types.
• util/icons: Centralizes icons and images for easy updates.
• appData: Includes app data, such as services and skills (including icons).
• app/page.tsx: Root file of the app.
• app/layout.tsx: Manages global and SEO configurations (e.g., fonts, head tags, analytics).

Customizing the Template

1. Navbar
   • File: navbar.tsx
     • Update the navbar name from john_doe to your name.
2. Hero Section
   • File: hero.tsx
     • Edit the title, description, and optionally, replace the SVG with your image.
3. Projects Section
   • File: content/projects
     • Replace the dummy projects with your own.
     • If you are modifying the properties or going to add new ones, then update types in types.d.ts.
4. Services Section
   • File: appData
     • Add your services with relevant icons. If icons are missing, contact me on LinkedIn or via email.
5. Skills Section
   • File: appData
     • Add your skills with relevant icons. Contact if you can’t find specific icons online.
6. Footer
   • Location: Visit Flexy UI
     • You can replace the default footer or choose from additional variants from Flexy UI (simple or column footer).

In the same manner, you can also update the Contact and Testimonial sections. The code is self-explanatory.

📨 Configuring the Contact Section

To integrate Formspree into your contact form, follow these simple steps:

1. Go to the Formspree website and create a new project.
2. Add a new form (you'll get a unique form endpoint URL).
3. Copy the form endpoint and paste it into your .env.local file like this:

CONTACT_FORM_ACTION_URL=https://formspree.io/f/your-form-id

Note: This URL is just an endpoint to receive your form submissions. You can use any service of your choice (like Formcarry, Getform, or your own API) if you're not using Formspree.

Make sure the name attributes in your form match what your form handler or service expects (e.g., name, email, subject, message).

Configuring Online Images

To display online images (e.g., from a CDN) in your deployed project, configure allowed image hostnames in next.config.js.

For demo purposes, we’re using Unsplash images. You can use any image host, but be sure to add the hostname in your configuration.

Replace 'unsplash' with your own image hostnames if using a different service or add a new object.

Theming and Styling

We use Tailwind CSS for styling. In global.css, you can customize theme variables for all 3 themes.

SEO & Branding

1. Favicon: Replace the default favicon with your own.
2. Metadata: Update meta title and description in layout.tsx.
3. SEO Files: robots.ts and sitemap.ts are included for search engines.
4. Open Graph Images:
   • Replace opengraph-image.png and twitter-image.png with custom images.
   • Alternatively, edit opengraph-image.tsx to generate images dynamically.

If you find this template helpful, don't forget to ⭐️ the repo!

💎 Upgrade to Premium

✨ Premium Features Include:

In premium template you will get one extra feature

• 📝 MDX Blog System with code snippets

Get Premium Version | View Premium Demo

🆓 vs 💎 Premium

Feature	Free Version	Premium Version
Blog System (MDX)	❌	✅ Full Integration
UI Components	20	25+
Email Support	✅	✅ Priority

Analytics

You can integrate analytics easily:

1. Simple Analytics or Vercel Analytics: Quick and easy to set up.
2. Google Analytics 4: Also straightforward.

Deployment Notes

Before deploying, add environment variables from .env.local wherever you are deploying:

1. NEXT_PUBLIC_SITE_URL: Set to your actual site URL (e.g., https://johndoe.com).
2. CONTACT_FORM_ACTION_URL: Your formspree url.
3. For local development, use the localhost URL.

For any query or suggestion, I am available on LinkedIn or email me at [email protected]