# ming

**Repository Path**: crazyants/ming

## Basic Information

- **Project Name**: ming
- **Description**: AI算命
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: http://ming.momen.vip
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-27
- **Last Updated**: 2026-01-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Ming - Fortune Telling App

A modern fortune-telling application built on Next.js 14, perfectly blending traditional metaphysical services with a contemporary user experience.

## ✨ Features

- **Intelligent Chart Generation**: Supports multiple fortune-telling methods including BaZi, Liu Yao, and Qi Men Dun Jia
- **Modern Interface**: Utilizes the Shadcn UI component library for elegant visual design
- **Animated Effects**: Unique character reveal animations and scrolling effects to enhance user experience
- **Theme Support**: Toggle between light and dark modes
- **Responsive Design**: Perfectly adapted for both desktop and mobile devices

## 🛠️ Tech Stack

- **Framework**: Next.js 14 (App Router)
- **UI Components**: Shadcn UI + Radix UI
- **Styling**: Tailwind CSS
- **Themes**: next-themes
- **Animations**: CSS Animations + Framer Motion

## 📦 Installation

```bash
# Clone the project
git clone https://gitee.com/crazyants/ming.git
cd ming

# Install dependencies
pnpm install

# Start the development server
pnpm dev
```

## 🚀 Usage

1. Visit `http://localhost:3000`
2. Fill in the required information in the form (name, birth date, etc.)
3. Click the "Start Fortune Reading" button
4. View your fortune reading results

## 📁 Project Structure

```
ming/
├── app/                    # Next.js application directory
│   ├── layout.tsx         # Application layout
│   └── page.tsx           # Homepage
├── components/            # React components
│   ├── fortune-form.tsx   # Fortune-telling form
│   ├── fortune-result.tsx # Fortune-telling result display
│   ├── character-reveal.tsx  # Character reveal animation
│   ├── scrolling-characters.tsx # Scrolling character effect
│   ├── settings-dialog.tsx    # Settings dialog
│   └── ui/               # Shadcn UI component library
├── hooks/                 # Custom Hooks
├── lib/                   # Utility functions
├── public/               # Static assets
└── styles/               # Global styles
```

## ⚙️ Configuration

The application supports personalized settings via `components/settings-dialog.tsx`, including:
- Theme mode toggle
- Animation effect toggles
- Other user experience settings

## 🤝 Contributions

Pull requests and issues are welcome to help improve this project.

## 📄 License

This project is licensed under the MIT License.