Skip to content

itxtalal/lunar-aura

Repository files navigation

LunarAura ✨🌙

Discover the Celestial Blueprint of Your Birth Moment

Project Screenshot/Demo Link

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)
    npm install -g pnpm

Installation

  1. Clone the repository:
    git clone https://github.com/itxtalal/lunar-aura
    cd lunar-aura
  2. Install dependencies:
    pnpm install

Running the Development Server

  1. Start the development server:
    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]