https://github.com/96syh/webvblog
Science Score: 26.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
○CITATION.cff file
-
✓codemeta.json file
Found codemeta.json file -
✓.zenodo.json file
Found .zenodo.json file -
○DOI references
-
○Academic publication links
-
○Academic email domains
-
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (9.5%) to scientific vocabulary
Repository
Basic Info
- Host: GitHub
- Owner: 96syh
- Language: TypeScript
- Default Branch: main
- Size: 0 Bytes
Statistics
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
- Releases: 0
Metadata Files
README.md
✨ Features
| 🎨 | Modern Design System Clean, minimalist interface with carefully crafted typography and spacing |
| 🌙 | Smart Theme Toggle Seamless dark/light mode with system preference detection |
| 📱 | Responsive Excellence Pixel-perfect design across all devices and screen sizes |
| ⚡ | Performance Optimized Built with Next.js 15, Turbopack, and modern optimization techniques |
| 📊 | Privacy-First Analytics Local analytics dashboard with zero external tracking |
| 🎭 | Smooth Animations Delightful micro-interactions powered by Framer Motion |
🚀 Quick Start
Prerequisites
- Node.js 18+ or Bun runtime
- Git
Installation
```bash
Clone the repository
git clone https://github.com/96syh/webvblog.git cd webvblog
Install dependencies (recommended: Bun for faster installs)
bun install
or npm install
Start development server
bun dev
or npm run dev
```
Visit http://localhost:3001 to see your portfolio in action.
🏗️ Architecture
├── src/
│ ├── app/ # Next.js App Router
│ │ ├── (pages)/ # Page routes
│ │ │ ├── about/ # About page
│ │ │ ├── work/ # Portfolio showcase
│ │ │ ├── blog/ # Blog system
│ │ │ └── analytics/ # Analytics dashboard
│ │ └── layout.tsx # Root layout
│ ├── components/ # Reusable components
│ │ ├── ui/ # Base UI components
│ │ ├── Sidebar.tsx # Navigation
│ │ └── ThemeProvider.tsx # Theme management
│ ├── contexts/ # React contexts
│ ├── lib/ # Utilities and configs
│ └── styles/ # Global styles
├── public/ # Static assets
└── docs/ # Documentation
🛠️ Tech Stack
Core Technologies
- **Framework**: Next.js 15 with App Router - **Language**: TypeScript - **Styling**: Tailwind CSS + CSS Variables - **Animations**: Framer Motion - **Icons**: Lucide React - **Font**: Inter (self-hosted)Development Tools
- **Runtime**: Bun - **Linting**: ESLint + Biome - **Type Checking**: TypeScript - **Git Hooks**: Husky - **Code Formatting**: PrettierPerformance Features
- **Bundler**: Turbopack (development) - **Image Optimization**: Next.js Image Component - **Font Optimization**: next/font - **Code Splitting**: Automatic - **PWA Ready**: Service Worker included📦 Available Scripts
```bash
Development
bun dev # Start development server with Turbopack bun build # Create production build bun start # Start production server bun preview # Preview production build locally
Code Quality
bun lint # Run ESLint bun type-check # TypeScript type checking bun format # Format code with Prettier
Testing
bun test # Run test suite bun test:watch # Run tests in watch mode bun test:coverage # Generate coverage report ```
🌐 Deployment
Vercel (Recommended)
Other Platforms
Netlify
```bash # Build command bun run build # Publish directory out ```Docker
```dockerfile FROM node:18-alpine AS base WORKDIR /app COPY package*.json ./ RUN npm ci --only=production COPY . . RUN npm run build EXPOSE 3000 CMD ["npm", "start"] ```🎨 Customization
Theme Configuration
typescript
// tailwind.config.ts
export default {
theme: {
extend: {
colors: {
primary: {
50: '#f0f9ff',
500: '#3b82f6',
950: '#172554',
}
}
}
}
}
Component Architecture
All components follow a consistent structure: - TypeScript interfaces for props - Responsive design patterns - Accessibility best practices - Performance optimizations
📈 Analytics
The built-in analytics system provides:
- Page Views: Track visitor engagement
- Session Data: Understanding user behavior
- Performance Metrics: Core Web Vitals monitoring
- Privacy Compliance: No external trackers, GDPR compliant
Access your analytics at /analytics route.
🤝 Contributing
We welcome contributions! Please see our Contributing Guide for details.
Development Workflow
- Fork the repository
- Create a feature branch:
git checkout -b feature/amazing-feature - Commit your changes:
git commit -m 'Add amazing feature' - Push to the branch:
git push origin feature/amazing-feature - Open a Pull Request
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
🙏 Acknowledgments
- Next.js - The React framework for production
- Tailwind CSS - A utility-first CSS framework
- Framer Motion - A production-ready motion library for React
- Lucide - Beautiful & consistent icon toolkit
Owner
- Login: 96syh
- Kind: user
- Repositories: 1
- Profile: https://github.com/96syh
GitHub Events
Total
- Watch event: 1
- Push event: 1
- Create event: 1
Last Year
- Watch event: 1
- Push event: 1
- Create event: 1
Dependencies
- @biomejs/biome 1.9.4 development
- @eslint/eslintrc ^3.3.1 development
- @types/node ^20.17.50 development
- @types/react ^18.3.22 development
- @types/react-dom ^18.3.7 development
- bippy ^0.3.16 development
- eslint ^9.27.0 development
- eslint-config-next 15.1.7 development
- postcss ^8.5.3 development
- tailwindcss ^3.4.17 development
- typescript ^5.8.3 development
- @notionhq/client ^3.1.3
- @vercel/analytics ^1.5.0
- class-variance-authority ^0.7.1
- clsx ^2.1.1
- framer-motion ^12.16.0
- lucide-react ^0.475.0
- next ^15.3.2
- next-themes ^0.4.6
- react ^18.3.1
- react-dom ^18.3.1
- tailwind-merge ^3.3.0
- tailwindcss-animate ^1.0.7