https://github.com/nramc/journeys
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.
https://github.com/nramc/journeys
angular geojson journey leafletjs nramc openstreetmap renovate-enabled single-page-app typescript
Last synced: 3 months ago
JSON representation
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.
- Host: GitHub
- URL: https://github.com/nramc/journeys
- Owner: nramc
- Created: 2023-10-20T17:41:44.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2025-03-12T08:25:30.000Z (7 months ago)
- Last Synced: 2025-03-12T09:24:33.579Z (7 months ago)
- Topics: angular, geojson, journey, leafletjs, nramc, openstreetmap, renovate-enabled, single-page-app, typescript
- Language: TypeScript
- Homepage: https://nramc.github.io/journeys/
- Size: 25.6 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 17
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
[](https://sonarcloud.io/summary/new_code?id=nramc_journeys)
[](https://github.com/nramc/journeys/releases)
[](https://nramc.github.io/journeys/)
[](https://www.linkedin.com/in/ramachandran-nellaiyappan/)
# Journeys
###### Your Portal to the Past
[](https://nramc.github.io/journeys/)
[](https://www.youtube.com/watch?v=1PECA_wra80)
[](https://www.youtube.com/watch?v=1PECA_wra80 "Watch on YouTube")
👉 Click the image above to watch a short demo of this project on YouTube.
**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](https://angular.io/) based Geo Spatial Single Page Application(SPA).
The Application is deployed using [gh-pages](https://pages.github.com/).
Since application uses geographical information, data is being processed in [GeoJSON](https://datatracker.ietf.org/doc/html/rfc7946) format.
[Open Street Map](https://www.openstreetmap.org/) is being used for displaying geospatial data with help of Map based JavaScript Library [Leaflet](https://leafletjs.com/).
## Helpful Links
- [Journeys Application](https://nramc.github.io/journeys/)
- [REST API Documentation](https://journey-api-nxm5.onrender.com/doc/swagger-ui.html)
- [REST Open API YML Configuration](https://journey-api-nxm5.onrender.com/doc/openapi)
## Getting Started
Please find below steps to set up and run application in your workstation.
### Prerequisites
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.
### Installation
1. Download Repository
```sh
git clone https://github.com/nramc/journeys.git
```
2. Set up your `environment.development.ts` to have
3. Development Journey-API BFF service
4. Your Cloudinary's `cloud name` and `preset`
5. Optional Cloudinary base directory for development
6. Run Application
```sh
npm run start
```
### Contribution
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".
1. Fork the Project
2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
3. Commit your Changes (`git commit -m 'feat: Add the AmazingFeature'`)
4. Push to the Branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request
### Release new version
1. Manually run [Release Workflow](https://github.com/nramc/journeys/actions/workflows/cd-workflow.yml)
2. The Workflow flow uses [Conventional Changelog Action Plugin](https://github.com/marketplace/actions/conventional-changelog-action), which determines next version based on commit logs
3. Based on the determined release type (MAJOR or MINOR or PATCH), bump version in package.json
4. The Workflow creates [Release](https://github.com/nramc/journeys/releases) as well with release notes and make the release as latest
5. As soon as new `Release` created, which triggers [gh-page deploy workflow](https://github.com/nramc/journeys/actions/workflows/pages/pages-build-deployment)
6. When build successful, Application available on [https://nramc.github.io/journeys](https://nramc.github.io/journeys/)
## Contact
[Ramachandran Nellaiyappan](https://nramc.github.io/my-profile/contact.html)
## Credits
Sincere Thanks to following open source community for their wonderful efforts to make our life much easier.
- [Open Street Map](https://www.openstreetmap.org) - Open Source Map Provider
- [Leaflet](https://leafletjs.com) - Map based JavaScript Library
- [GitHub Pages](https://pages.github.com/) - Hosting static resources
- [Angular](https://angular.io/) - TypeScript based Single Page Application(SPA) Web Framework
- [Angular Material](https://material.angular.io/) - Open Source UI Component library for Angular
- [Angular Gallery](https://github.com/MurhafSousli/ngx-gallery/wiki) - Open Source Media Gallery library for Angular
## Show your support
Give a ⭐️ if you like this project!