Skip to content
tunnels-isPublic

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Modern React Website

A beautiful, modern website built with React, Tailwind CSS, and Framer Motion featuring a dark theme and smooth scroll animations.

Features

  • ✨ Modern dark theme design
  • 🎨 Smooth animations with Framer Motion
  • 📱 Fully responsive across all devices
  • 🚀 Fast performance with Vite
  • 🎯 Client-side routing with React Router
  • 💅 Styled with Tailwind CSS v4
  • ♿ Accessible and semantic HTML

Tech Stack

  • React 19 - UI library
  • Vite - Build tool and dev server
  • React Router DOM - Client-side routing
  • Tailwind CSS v4 - Utility-first CSS framework
  • Framer Motion - Animation library

Project Structure

website-new/
├── src/
│   ├── components/       # Reusable components
│   │   ├── TopBar.jsx   # Navigation bar
│   │   ├── Layout.jsx   # Layout wrapper
│   │   └── Footer.jsx   # Footer component
│   ├── pages/           # Page components
│   │   ├── Home.jsx     # Home page with hero
│   │   ├── About.jsx    # About page
│   │   ├── Projects.jsx # Projects showcase
│   │   ├── Contact.jsx  # Contact form
│   │   └── NotFound.jsx # 404 page
│   ├── hooks/           # Custom React hooks
│   │   └── useScrollAnimation.js
│   ├── App.jsx          # Main app component
│   ├── main.jsx         # Entry point
│   └── index.css        # Global styles
├── public/              # Static assets
├── index.html          # HTML template
├── vite.config.js      # Vite configuration
├── tailwind.config.js  # Tailwind configuration
└── package.json        # Dependencies and scripts

Getting Started

Prerequisites

  • Node.js 18+ installed
  • npm or yarn package manager

Installation

  1. Install dependencies:
npm install
  1. Start the development server:
npm run dev
  1. Open your browser and visit http://localhost:5173

Building for Production

Build the project for production:

npm run build

Preview the production build:

npm run preview

The built files will be in the dist/ directory, ready to be deployed to any static hosting service.

Available Scripts

  • npm run dev - Start development server (accessible on 0.0.0.0:5173)
  • npm run build - Build for production
  • npm run preview - Preview production build locally
  • npm run screenshot - Take screenshots of all pages (multiple viewports)
  • npm run screenshot:quick <url> - Take a quick screenshot of a specific page

Customization

Colors

Update the color scheme in src/index.css within the @theme block:

@theme {
  --color-dark-bg: #0a0a0a;
  --color-dark-surface: #121212;
  --color-dark-accent-primary: #3b82f6;
  /* ... more colors */
}

Navigation Links

Edit navigation links in src/components/TopBar.jsx:

const navLinks = [
  { path: '/', label: 'Home' },
  { path: '/about', label: 'About' },
  // Add more links...
];

Animations

The project uses Framer Motion for animations. Customize animation variants in individual components or create reusable animation presets.

Screenshots

Take screenshots during development using Puppeteer:

# Screenshot a specific page
npm run screenshot:quick http://localhost:5173/about

# Screenshot with custom viewport
node scripts/take-screenshot.js http://localhost:5173 mobile 375 667

# Screenshot all pages and viewports
npm run screenshot

See SCREENSHOTS.md for detailed documentation.

Deployment

This is a static website that can be deployed to:

  • Vercel - vercel deploy
  • Netlify - Drag and drop the dist/ folder
  • GitHub Pages - Use GitHub Actions
  • Cloudflare Pages - Connect your repository
  • Any static hosting service

Important for Deployment

For client-side routing to work properly on static hosts:

  1. For Netlify/Vercel: They handle routing automatically
  2. For GitHub Pages: Consider using HashRouter instead of BrowserRouter
  3. For other hosts: Configure your server to redirect all routes to index.html

Browser Support

  • Chrome (latest)
  • Firefox (latest)
  • Safari (latest)
  • Edge (latest)

Performance

  • Lighthouse Score: 95+ (Performance)
  • First Contentful Paint: < 1s
  • Time to Interactive: < 2s
  • Bundle size optimized with code splitting

Accessibility

  • Semantic HTML elements
  • ARIA labels where needed
  • Keyboard navigation support
  • Focus indicators
  • Respects prefers-reduced-motion

Future Enhancements

See TASK.md for the full development roadmap and optional features to add:

  • Blog section with MDX support
  • Search functionality
  • Theme toggle (dark/light)
  • More page transitions
  • Analytics integration
  • Form validation and submission
  • Image optimization

License

ISC

Contributing

Feel free to fork this project and customize it for your needs!


Built with ❤️ using React, Vite, Tailwind CSS, and Framer Motion

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages