Current Version: vX.X.X
Welcome to the Currencies Archiving & Sharing Hub (CASH), your gateway to organizing and showcasing your currency collection to the world. This open-source project is built to serve collectors while inviting contributions to grow its features and reach.
Currencies Archiving & Sharing Hub (CASH) is a user-friendly web app designed for currency collectors who want to organize, document, and share their collections with others. Whether you’re a hobbyist or a professional collector, CASH provides an efficient platform to catalog detailed information about your currencies, including continent, zone, type, value, and more.
The best part? CASH is open-source, so you can contribute to its development, suggest features, or even fork it to create your own customized version.
-
Comprehensive Listings
Enlist detailed information about your currencies, including type, value, continent, zone, and more. -
Interactive Showroom
Public visitors can browse your collection using advanced filtering options. -
Secured Access
Admin-only access for data manipulation with Firebase authentication. -
Open-Source
Totally transparency and ability for any web developer to contribute and enhance. -
Modern Tech Stack
Built with Vue.js 3 and Firebase for an optimized, scalable, and responsive web experience.
-
Enhanced Admin Dashboard
A feature-rich panel for currency management, detailed reports, and advanced data analysis. -
Advanced Statistics
A dedicated dashboard showcasing charts, maps, and key statistics like total counts, collection value, and rare pieces. -
Market Insights
Automated total value estimation for your collection based on circulable values. -
Social Media Integration
Share your showroom or latest additions on popular platforms. -
Automatic Photo Integration
Automatically find and attach appropriate images for each currency piece. -
Expansion to Other Collections
Extend the app to support other types of collections, such as stamps or photos. -
Centralized Currencies Database
A database for you to identify which currencies are out there to collect. With community-contributed updates. -
Advanced Features
- Generate a PDF catalog of your collection.
- Collection progress tracking with timelines.
- Localization for administrators and browsers.
-
Centralized Services
- Support for user registrations and subscriptions.
- Automated subdomain creation for personal showrooms.
- SaaS platform for collectors with community-driven updates and premium features.
Demo Live (Developer's Own Showroom)
For a full list of changes, see the Changelog.
- Frontend: Vue.js 3, Nuxt
- Backend: Firebase Realtime Database, Firebase Authentication
- UI Framework: Bootstrap 5
- Charts and Visualization: ApexCharts
- Development Tools: Yarn, ESLint, Prettier
Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.
To contribute:
- Fork the project.
- Create your feature branch:
git checkout -b feature/YourFeatureName. - Commit your changes:
git commit -m 'Add some YourFeatureName'. - Push to the branch:
git push origin feature/YourFeatureName. - Open a pull request.
Please ensure your code adheres to the project's guidelines and is well-documented.
- Fork the repository to your GitHub account.
- Clone the forked repository to your local machine.
- Navigate to the project root directory:
cd cash-hub- Install dependencies:
npm i- Start the development server:
npm run dev- Open your browser and navigate to the development server URL (usually
http://localhost:3000) to view the application. - Make changes to the code as needed, and watch for live updates using Vue's Hot Module Replacement (HMR).
We welcome contributions and feedback! To report a bug, suggest a feature, or request support:
-
Go to the Issues tab of this repository.
-
Click on New Issue.
-
Select the appropriate issue template:
- Bug Report: If you found a bug or error in the app.
- Feature Request: If you have an idea for a new feature or improvement.
-
Fill out the form with as much detail as possible.
-
Submit the issue, and we’ll review it as soon as possible.
If you encounter any issues, have questions, or want to suggest improvements, feel free to:
- Open an issue on the GitHub repository.
- Reach out to the project maintainer via the contact information provided in the repository.
- Join the discussions on the repository to collaborate with other contributors.
We appreciate your feedback and contributions to make the "Currencies Archiving & Sharing Hub" better for everyone!
Your support is vital to making Currencies Archiving & Sharing Hub even better! Here’s how you can contribute and help spread the word:
Dive into the codebase, identify bugs, or build new features. Check out our Developer Notes for more details on how to get started.
Starring our repository is a quick and easy way to show your support and help others discover this project.
👉 Click here to star the repo 👈
Your financial support can accelerate the development of Currencies Archiving & Sharing Hub by covering costs like hosting, integrations, and feature enhancements.
👉 Become a Sponsor 👈
Help us reach more users and contributors by sharing the project with your network!
Click below to share on your favorite platform:
This project is licensed under the MIT License. See the LICENSE file for more details.
- Nuxt.js - The frontend framework that powers this app.
- Firebase - The backend platform used for data storage and authentication.
- Bootstrap - The CSS framework for responsive design.
- All contributors who have helped build and improve this project.
This is Suhaib Ahmad, a software developer passionate about leveraging technology to improve health and wellness.
- Website: Suhaib.dev
- GitHub: Makkahwi
- Email: SuhaibAhmadAi@hotmail.com
If you have any questions about the project, feel free to reach out the developer.
Thank you for your interest in "Currencies Archiving & Sharing Hub"! Together, we can make it the go-to solution for collectors worldwide.
