Thanks to visit codestin.com
Credit goes to github.com

Skip to content

A responsive full-stack web application that allows users to submit, browse, and interact with historical artifacts. The platform supports user authentication, personalized dashboards, and an interactive like system to engage artifact enthusiasts.

Notifications You must be signed in to change notification settings

Ik-Riyad/historical-artifacts-client

Repository files navigation

🏺 Historical Artifacts Tracker

🔎 Project Overview

A responsive full-stack web application that allows users to explore, share, and submit historical artifacts. Users can like their favorite artifacts, which are saved in their profile for easy access. The platform supports user authentication and enables seamless artifact sharing.


📸 Screenshot

Project Screenshot


🛠 Technologies Used

  • React.js (Frontend UI)
  • Node.js & Express (Backend API)
  • MongoDB (Database)
  • Axios (HTTP client)
  • Firebase Authentication (User auth and protected routes)
  • Tailwind CSS (Styling)

✨ Core Features

  • Stylish landing page with slider/banner, featured artifact cards, and informative sections.
  • View all artifacts submitted by users on a dedicated page.
  • Authenticated users can add new artifacts with details including name, image, and description.
  • User Dashboard accessible via profile icon, showing:
    • Artifacts created by the user (My Artifacts)
    • Artifacts liked by the user (Liked Artifacts)
  • Interactive like system allowing users to like or unlike artifacts; liked artifacts are saved per user.
  • Firebase-based authentication with protected routes for adding artifacts, liking items, and accessing the user dashboard.

⚙️ Dependencies

  • react, react-dom
  • axios
  • firebase
  • react-router-dom
  • express
  • mongoose
  • dotenv
  • tailwindcss

🚀 How to Run Locally

  1. Clone the repository:

    git clone https://github.com/Ik-Riyad/historical-artifacts-client.git
    cd your-repo-name
    
  2. Install frontend dependencies:

  • cd client
  • npm install
  1. Install backend dependencies:
  • cd ../server
  • npm install
  1. Setup environment variables:
  • Create .env files in both client and server directories.

  • Add your MongoDB URI, Stripe keys, Firebase config, and other sensitive data.

  1. Start backend server:
  • npm run dev
  1. Start frontend app:
  • cd ../client
  • npm start
  1. Open in browser:

🔗 Live Project

📬 Contact

About

A responsive full-stack web application that allows users to submit, browse, and interact with historical artifacts. The platform supports user authentication, personalized dashboards, and an interactive like system to engage artifact enthusiasts.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages