naga-k / 3D_Portfolio

https://3-d-portfolio-tau-three.vercel.app
0 stars 0 forks source link

3D Portfolio

A Next.js-based portfolio website for showcasing interactive 3D scenes using Splat visualization technology.

Demo: Hosted on Vercel

Overview

This portfolio website features:

Getting Started

Prerequisites

Installation

  1. Clone the repository

  2. Install dependencies:

    npm install
    # or
    yarn install
    # or
    pnpm install
    # or
    bun install
  3. Copy environment variables:

    cp example.env.local .env.local
  4. Start the development server:

    npm run dev
    # or
    yarn dev
    # or
    pnpm dev
    # or
    bun dev
  5. Open http://localhost:3000 with your browser to see the result.

Database Setup

Using NeonDB

  1. Set up environment variables:

    • Ensure DATABASE_URL is configured in .env.local
  2. Generate migration files:

    npx drizzle-kit generate
  3. Run migrations:

    npx drizzle-kit migrate
  4. Insert dummy data:

    • Use the SQL script located at script/insertSplat.sql
    • Execute the script against your Postgres database in NeonDB

Alternative: Local JSON Data

You can alternatively add items directly to public/splatData.json:

{
  "items": [
    {
      "src": "s3://your-bucket/path",
      "splatSrc": "s3://your-bucket/splat-path"
    }
  ]
}

Technical Stack

Viewer Technology

Asset Storage

Framework

Deployment

Deploy on Vercel (recommended):

  1. Visit the Vercel Platform
  2. Follow the deployment steps

For more deployment options, see the Next.js deployment documentation.

Learn More