Journey is a personal project designed to help users document and relive their travel experiences in a rich, immersive way. The platform allows travellers to seamlessly store memories of their trips, combining textual narration, geographic information, and multimedia elements such as photos and videos.
With Journey, users can:
- Capture stories of their adventures with detailed narratives.
- Log geotagged locations to visually map their travel routes and destinations.
- Upload and organize images and videos, creating a digital scrapbook of their experiences.
Whether it’s a weekend getaway or a year-long adventure, Journey enables users to keep all their cherished travel moments in one organized place, transforming trips into unforgettable stories.
This is an Angular based Geo Spatial Single Page Application(SPA). The Application is deployed using gh-pages.
Since application uses geographical information, data is being processed in GeoJSON format. Open Street Map is being used for displaying geospatial data with help of Map based JavaScript Library Leaflet.
Please find below steps to set up and run application in your workstation.
The service uses MongoDB for persistence. For Local development, Local MongoDB instance created with help of Docker CLI. So make sure you have installed Docker CLI or any other docker container tool.
- Download Repository
git clone https://github.com/nramc/journeys.git
- Set up your
environment.development.tsto have - Development Journey-API BFF service
- Your Cloudinary's
cloud nameandpreset - Optional Cloudinary base directory for development
- Run Application
npm run start
Any contributions you make are greatly appreciated.
If you like the project and have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -m 'feat: Add the AmazingFeature') - Push to the Branch (
git push origin feature/AmazingFeature) - Open a Pull Request
- Manually run Release Workflow
- The Workflow flow uses Conventional Changelog Action Plugin, which determines next version based on commit logs
- Based on the determined release type (MAJOR or MINOR or PATCH), bump version in package.json
- The Workflow creates Release as well with release notes and make the release as latest
- As soon as new
Releasecreated, which triggers gh-page deploy workflow - When build successful, Application available on https://nramc.github.io/journeys
Ramachandran Nellaiyappan Website | Twitter | E-Mail
Sincere Thanks to following open source community for their wonderful efforts to make our life much easier.
- Open Street Map - Open Source Map Provider
- Leaflet - Map based JavaScript Library
- GitHub Pages - Hosting static resources
- Angular - TypeScript based Single Page Application(SPA) Web Framework
- Bootstrap - Open Source CSS Framework
- Angular Material - Open Source UI Component library for Angular
- Angular Gallery - Open Source Media Gallery library for Angular
Give a ⭐️ if you like this project!