Family Maps Tracker is an interactive web application designed to help users track and visualize the countries that they and their family members have visited. The application features a dynamic world map where users can add or remove countries to their visited list, manage family member profiles, and view the travel history in a colorful, intuitive format.
- User Management: Add and manage family member profiles, allowing personalized tracking for each user.
- Country Tracking: Users can add or remove countries from their personal visited list through an intuitive interface.
- Dynamic Visualization: The world map dynamically updates to reflect the visited countries, highlighted in different colors based on the user's profile.
- Responsive Design: Fully responsive web design that adjusts to various devices and screen sizes, ensuring a seamless experience on desktops, tablets, and smartphones.
- Interactive UI: Users can interact with the map and the user interface to dynamically add or delete countries and users.
Node.js: Server-side JavaScript runtime environment that runs on the V8 engine and executes JavaScript code outside a web browser. Express.js: Web application framework for Node.js, designed for building web applications and APIs. PostgreSQL: Open source relational database with an emphasis on extensibility and SQL compliance. EJS: Templating language that lets you generate HTML markup with plain JavaScript which is a good choice for building dynamic web pages. CSS: Styling of the application to make it visually appealing and functional on different devices.
Before you can run Family Maps Tracker locally, make sure you have the following installed:
- Node.js
- npm (Node Package Manager)
- PostgreSQL
- Clone the repository:
git clone https://github.com/matbuha/family-maps-tracker.git
cd family-maps-tracker
- Install dependencies:
npm install
- Setup the database:
- Ensure PostgreSQL is running.
- Create a database named
worldand import any necessary initial data or schema from a provided SQL file.
- Environment Configuration:
For security reasons, configure your database credentials and other sensitive data using environment variables. Create a
.envfile in the root directory of your project and add the following:
DB_USER=yourusername
DB_HOST=localhost
DB_DATABASE=permalist
DB_PASSWORD=yourpassword
DB_PORT=5432
Replace the placeholders with your actual database configuration.
- Start the application:
npm start
- Visit the application in your web browser:
- Open http://localhost:3000 to start using Family Maps Tracker.
Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.
Distributed under the MIT License. See LICENSE for more information.
Ariel Ben Zikri - [email protected]