Skip to content

hitX/Lost_Found_System

Repository files navigation

Lost & Found System

This is a simple Lost & Found web application built as a static site using HTML, CSS and JavaScript. The UI uses the AdminLTE dashboard template for the admin/dashboard interface.

Repository structure

  • index.html - landing/home page
  • add-post.html - form to add a lost/found post
  • dashboard.html - main dashboard view
  • admin.html - admin dashboard (AdminLTE)
  • my-posts.html, others-posts.html - listing pages
  • chat.html, Notifications.html - real-time UI pages
  • login.html, reset-password.html - auth pages
  • static/Js/ - JavaScript source files used by the pages (e.g., add-post.js, dashboard.js, login.js, etc.)

How to run locally

This is a static project; you can run it by serving the files with a simple static server. From the repository root, using PowerShell, run:

# Python 3 built-in HTTP server
python -m http.server 8000

Then open http://localhost:8000 in your browser. Alternatively, use the VS Code Live Server extension or any static file server.

Note: Because this is a static front-end, some functionality (auth, persistent data, admin actions) may require a backend which is not included in this repository. When testing features that rely on a backend, either mock the API calls or wire a suitable backend.

Backend

This project can be integrated with Firebase to provide authentication, persistent storage, file uploads, and optional serverless functions. Common Firebase services to use:

  • Authentication — handle sign-up, sign-in, password reset.
  • Firestore (or Realtime Database) — store posts, user profiles, chat messages.
  • Storage — store uploaded images for lost/found items.
  • Hosting / Cloud Functions — optional: host the site or run server-side logic.

Quick integration notes:

  1. Create a Firebase project at https://console.firebase.google.com and add a Web app.
  2. Enable the services you need (Authentication, Firestore/Realtime DB, Storage). Configure security rules appropriate for your app.
  3. Copy the Firebase config object for the web app and initialize Firebase in your front-end. Example (create static/Js/firebase-config.js):
<!-- include Firebase SDK (CDN) in your HTML before app scripts -->
<script src="https://www.gstatic.com/firebasejs/9.23.0/firebase-app-compat.js"></script>
<script src="https://www.gstatic.com/firebasejs/9.23.0/firebase-auth-compat.js"></script>
<script src="https://www.gstatic.com/firebasejs/9.23.0/firebase-firestore-compat.js"></script>
<script src="/static/Js/firebase-config.js"></script>
// 
const firebaseConfig = {
	apiKey: "YOUR_API_KEY",
	authDomain: "YOUR_PROJECT_ID.firebaseapp.com",
	projectId: "YOUR_PROJECT_ID",
	storageBucket: "YOUR_PROJECT_ID.appspot.com",
	messagingSenderId: "...",
	appId: "..."
};
firebase.initializeApp(firebaseConfig);
// export or attach firebase services as needed (auth, firestore, storage)
  1. Update your existing JS (for example add-post.js, login.js, etc.) to call Firebase APIs to authenticate users, read/write posts, and upload images.
  2. For local testing of Firestore/Functions, consider using the Firebase Emulator Suite. For deployment, use firebase deploy (Hosting/Functions) or serve static files with your preferred host.

About

Lost & Found System — a lightweight web app for reporting and managing lost & found items with an AdminLTE dashboard and Firebase backend.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors