Skip to content

pronzzz/posties

Repository files navigation

Posties 📯

Posties Banner License React TypeScript

Posties is a beautifully crafted digital postcard collection that brings back the charm of thoughtful correspondence in a modern web experience. Explore memories through an immersive 3D carousel or a clean grid layout.

✨ Features

  • 3D Carousel View: An interactive, rotating display of postcards that simulates a real-world collection.
  • Grid View: A structured, gallery-style layout for easy browsing.
  • Immersive Details: Click any postcard to view it up close with details and stories.
  • Smooth Animations: Fluid transitions and micro-interactions for a premium feel.
  • Responsive Design: Optimized for various screen sizes.

🚀 Getting Started

Follow these steps to get a local copy up and running.

Prerequisites

  • Node.js (v16 or higher)
  • npm or yarn

Installation

  1. Clone the repository

    git clone https://github.com/pronzzz/posties.git
    cd posties
  2. Install dependencies

    npm install
  3. Start the development server

    npm run dev

    Open http://localhost:5173 with your browser to see the result.

🛠️ Built With

  • React 19: The library for web and native user interfaces.
  • TypeScript: Strongly typed JavaScript.
  • Vite: Next Generation Frontend Tooling.
  • Tailwind CSS: Utility-first CSS framework.
  • Lucide React: Beautiful & consistent icons.
  • Radix UI: Unstyled, accessible components (via Shadcn concepts).

📂 Project Structure

Please refer to the Developer Guide for a detailed walkthrough of the codebase and architecture.

🤝 Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

See CONTRIBUTING.md for more information.

📄 License

Distributed under the MIT License. See LICENSE for more information.

📬 Contact

Project Link: https://github.com/pronzzz/posties


Created with ❤️ for the thoughtful wanderer.

About

Posties is a digital postcard collection application featuring an immersive 3D carousel and grid layout for exploring curated memories. Built with React 19, TypeScript, and Tailwind CSS, it offers fluid animations and a responsive design to modernize the charm of thoughtful correspondence.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Contributors