https://github.com/itxtalal/lunar-aura
Discover Your Lunar Destiny
https://github.com/itxtalal/lunar-aura
astrology birth-chart birthday celestial framer-motion lunar moon-phase nextjs react
Last synced: 29 days ago
JSON representation
Discover Your Lunar Destiny
- Host: GitHub
- URL: https://github.com/itxtalal/lunar-aura
- Owner: itxtalal
- Created: 2025-06-03T19:39:04.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-06-05T09:01:00.000Z (12 months ago)
- Last Synced: 2025-06-20T04:04:00.806Z (12 months ago)
- Topics: astrology, birth-chart, birthday, celestial, framer-motion, lunar, moon-phase, nextjs, react
- Language: TypeScript
- Homepage: https://lunar-aura.vercel.app
- Size: 473 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# LunarAura ✨🌙
**Discover the Celestial Blueprint of Your Birth Moment**
[](https://lunar-aura.vercel.app/og-image.png)
LunarAura is a modern web application that calculates and visualizes your unique "Lunar Birth Chart." By simply entering your birth date, you can uncover the moon phase, illumination, lunar age, and key characteristic traits influenced by the celestial energies present at the exact moment you were born.
This project aims to provide a beautifully designed and intuitive way for anyone to connect with the cosmic rhythms that shaped their beginnings.
## Features
- **Personalized Lunar Birth Chart:** Get a detailed chart based on your specific birth date.
- **Interactive Moon Phase Display:** Visualize the exact phase of the moon at your birth with stunning clarity.
- **Key Characteristics:** Discover traits and insights derived from your birth moon phase and celestial influences, presented as aesthetic badges.
- **Celestial Influences:** Explore deeper insights into planetary and zodiac influences through an elegant tabbed interface.
- **Shareable Link:** Easily generate a unique link to share your personalized Lunar Birth Chart with friends and family.
- **Beautiful UI/UX:** Crafted with a focus on aesthetics, smooth animations, and user experience.
- **Responsive Design:** Access your chart seamlessly on any device.
- **Dynamic Background:** Enjoy a subtle, captivating particles background effect.
## Why LunarAura?
Built out of curiosity and a passion for combining technology with ancient wisdom, LunarAura provides a fresh perspective on personal astrology and lunar cycles. It's perfect for anyone interested in:
- Learning about their birth moon sign.
- Exploring how lunar and celestial energies might influence personality.
- Sharing a unique piece of personal cosmic information.
## Technologies Used
- **Next.js:** A powerful React framework for building fast web applications.
- **React:** For building the user interface with reusable components.
- **TypeScript:** Ensuring type safety and developer productivity.
- **Tailwind CSS:** For rapid and flexible styling.
- **Framer Motion:** Adding delightful animations and transitions.
- **@tsparticles/react:** Creating the interactive background particle effect.
- **Shadcn/ui:** Providing accessible and customizable UI components (like the date picker elements and tabs).
## Getting Started
Follow these steps to get the project up and running on your local machine.
### Prerequisites
- Node.js (v18 or higher recommended)
- pnpm (or npm/yarn)
```bash
npm install -g pnpm
```
### Installation
1. Clone the repository:
```bash
git clone https://github.com/itxtalal/lunar-aura
cd lunar-aura
```
2. Install dependencies:
```bash
pnpm install
```
### Running the Development Server
1. Start the development server:
```bash
pnpm dev
```
2. Open your browser and visit `http://localhost:3000`.
## Contributing
We welcome contributions to LunarAura! Whether it's reporting a bug, suggesting a new feature, or submitting a pull request, your help is appreciated.
1. Fork the repository.
2. Create your feature branch (`git checkout -b feature/AmazingFeature`).
3. Commit your changes (`git commit -m 'Add some AmazingFeature'`).
4. Push to the branch (`git push origin feature/AmazingFeature`).
5. Open a Pull Request.
## Contact
If you have any questions or feedback, feel free to open an issue or contact [[itxtalal@gmail.com](mailto:itxtalal@gmail.com)]