╔══════════════════════════════════════════════════════════════════════════════════════╗
║ ║
║ ██╗ ██╗███╗ ███╗██████╗ ███████╗ ██████╗ ███╗ ██╗ ║
║ ██║ ██║████╗ ████║██╔══██╗██╔════╝██╔═══██╗████╗ ██║ ║
║ ██║ ██║██╔████╔██║██████╔╝█████╗ ██║ ██║██╔██╗ ██║ ║
║ ╚██╗ ██╔╝██║╚██╔╝██║██╔═══╝ ██╔══╝ ██║ ██║██║╚██╗██║ ║
║ ╚████╔╝ ██║ ╚═╝ ██║██║ ███████╗╚██████╔╝██║ ╚████║ ║
║ ╚═══╝ ╚═╝ ╚═╝╚═╝ ╚══════╝ ╚═════╝ ╚═╝ ╚═══╝ ║
║ ║
║ 灵墟 · Archive of Lost Cultivation ║
║ ║
║ 末法时代 · 失落修行文明档案馆 ║
║ ║
╚══════════════════════════════════════════════════════════════════════════════════════╝
LingXu (灵墟, "Spirit Ruins") is an immersive digital archive exploring Chinese metaphysics and the rise and fall of cultivation civilizations.
In the year 2026 of the final age,灵气 (spiritual energy) has declined for millennia. History is sealed. People have forgotten those real cultivators—Laozi flying to heaven, Zhuangzi transforming into a butterfly... These are not myths, but real cultivators who once existed.
灵墟档案馆 is dedicated to preserving these forgotten cultivation civilizations and exploring the mysteries of heaven and earth.
| Feature | Description | Status |
|---|---|---|
| 🌌 Immersive Experience | WebGL 3D starfield, particle systems, ink-wash backgrounds | ✅ |
| ☯️ Metaphysics Tools | Yijing divination, Bazi fortune-telling, Feng Shui compass, Talisman generation | ✅ |
| 📜 Rich Content | Eight modules, hundreds of sub-pages, detailed interpretations | ✅ |
| 🎮 Interactive Features | Daily check-in, divination hall, cultivation simulator | ✅ |
| 🌙 Mystical Design | Xianxia-style interface, profound cultural atmosphere | ✅ |
| 🎨 3D Effects | Three.js powered visualizations | ✅ |
| Module | Description | Content |
|---|---|---|
| ☁️ 天 (Heaven) | Celestial operations, star changes | Constellations, fortune, solar terms, divination |
| 🏔️ 地 (Earth) | Geography, Feng Shui | Geomancy, compass, dragon veins, geography |
| 🔮 玄 (Mystery) | Yijing, Ba Gua, talismans | I Ching, Bazi, divination, talismans |
| 📜 黄 (Yellow) | Ancient history, secret archives | Dynasties, figures, secrets, documents |
| 🌌 宇 (Cosmos) | Multi-layered realms | Three realms, cave heavens, dimensions |
| ⏳ 宙 (Time) | River of time, reincarnation | Reincarnation, karma, prophecy |
| 🐉 洪 (Flood) | Mythical beasts, legends | Divine beasts, demons, legends, totems |
| 🏛️ 荒 (Wasteland) | Lost techniques, fallen civilization | Cultivation methods, elixirs, artifacts |
Visit: https://badhope.github.io/LingXu
# Clone repository
git clone https://github.com/badhope/LingXu.git
cd LingXu
# Install dependencies
pnpm install
# Start dev server
pnpm dev
# Build static site
pnpm build
# Export static files
pnpm export| Category | Technology |
|---|---|
| Framework | Next.js 14 (React 18) |
| Language | TypeScript 5 |
| Styling | Tailwind CSS + SCSS Modules |
| Animation | Framer Motion |
| 3D Rendering | Three.js + React Three Fiber |
| State | Zustand |
| Charts | ECharts |
| Calendar | lunar-javascript |
| Element | Value |
|---|---|
| Primary Color | Gold (#c9a227) |
| Secondary Color | Mystic Black (#1a1a2e) |
| Accent | Glowing stars effect |
| Atmosphere | Mysterious, profound, Xianxia-inspired |
| Type | Description |
|---|---|
| Particle Systems | Starfield, light particles, dragon-shaped particles |
| Orbital Systems | Rotating orbits, symbol encirclement |
| Taiji Diagram | Rotation, glow, interaction |
| Transitions | Page transitions, element entrances |
| Platform | Experience |
|---|---|
| Desktop | Full experience |
| Tablet | Adaptive layout |
| Mobile | Simplified animations, touch optimization |
LingXu integrates multiple free APIs:
| Type | API | Usage |
|---|---|---|
| Astronomy | NASA API | Daily astronomy images, star maps |
| Weather | Qweather | Solar terms, weather queries |
| Calendar | Public Calendar API | Holidays, lunar conversion |
| Constellation | Built-in algorithms | Constellation calculation, fortune generation |
Note: Some features use local algorithms, no external API required
LingXu/
├── src/
│ ├── components/ # Components
│ │ ├── background/ # Background (starfield, orbits)
│ │ ├── interactive/ # Interactive (Taiji, Ba Gua)
│ │ ├── layout/ # Layout components
│ │ └── splash/ # Splash screen
│ ├── hooks/ # Custom hooks
│ ├── lib/ # Utilities
│ │ ├── constants.ts # Constants
│ │ └── utils.ts # Helpers
│ ├── pages/ # Route pages
│ │ ├── index.tsx # Entry
│ │ ├── home.tsx # Home
│ │ ├── tian.tsx # Heaven module
│ │ ├── di.tsx # Earth module
│ │ ├── xuan.tsx # Mystery module
│ │ ├── huang.tsx # History module
│ │ ├── yu.tsx # Space module
│ │ ├── zhou.tsx # Time module
│ │ ├── hong.tsx # Legends module
│ │ └── huang-lost.tsx # Lost module
│ ├── stores/ # State management
│ └── styles/ # Global styles
├── public/ # Static assets
├── docs/ # Documentation
└── [config files]
All forms of contribution are welcome!
| Type | Description |
|---|---|
| 📝 Content | Add metaphysics knowledge, historical data, mythical stories |
| 💻 Code | Fix bugs, add features, optimize performance |
| 🎨 Design | Improve UI, add animations, design assets |
| 🌐 Translation | Translate to other languages |
- Fork this repository
- Create feature branch (
git checkout -b feature/amazing-feature) - Commit changes (
git commit -m 'Add amazing feature') - Push branch (
git push origin feature/amazing-feature) - Submit Pull Request
This project is licensed under MIT License - see LICENSE.
⚠️ Disclaimer:
- This project is for entertainment and learning purposes only
- Metaphysics content is from traditional culture and does not represent scientific views
- If there is any infringement, please contact the author for removal
| Channel | Link |
|---|---|
| 🐛 Bug Reports | GitHub Issues |
| 💬 Discussions | GitHub Discussions |
| 🌐 Homepage | https://badhope.github.io/LingXu |
🙏 May you find your own path of cultivation in LingXu 🙏
"愿你在灵墟中找到属于自己的修行之路"
"May you find your own path of cultivation in LingXu"
Made with ❤️ by LingXu Team
Home • Releases • Issues • Discussions