https://github.com/fauxtix/stampcollectorapp
Application for stamp collectors, developed in .NET MAUI
https://github.com/fauxtix/stampcollectorapp
csharp dependency-injection localization mobile-development mvvm sqlite xaml
Last synced: 12 months ago
JSON representation
Application for stamp collectors, developed in .NET MAUI
- Host: GitHub
- URL: https://github.com/fauxtix/stampcollectorapp
- Owner: fauxtix
- License: mit
- Created: 2025-05-28T14:44:03.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2025-06-22T11:23:26.000Z (about 1 year ago)
- Last Synced: 2025-06-22T12:26:17.906Z (about 1 year ago)
- Topics: csharp, dependency-injection, localization, mobile-development, mvvm, sqlite, xaml
- Language: C#
- Homepage:
- Size: 17 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.en.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# StampCollectorApp
[🇵🇹 Portuguese version](./README.md)
> **StampCollectorApp** is a cross-platform app for stamp collectors, developed with .NET MAUI (.NET 8). It allows intuitive and organized management of stamps, exchanges, collections, categories, and images.
---
## ✨ Features
- **Stamp Management:** Add, edit, remove, and search for stamps.
- **Collections:** Organize stamps into collections, tracking expected and collected quantities.
- **Categories:** Classify stamps by custom categories.
- **Images:** Attach local images or search for stamp images via the Pixabay API.
- **Smart Validation:** Required fields, date checks, positive values, and more.
- **Exchange Mode:** Mark stamps as available for exchange.
- **Registering Exchanges:** Easily record a stamp exchange with another collector. After selecting a stamp for exchange, fill in the collector's name and contact information, and add notes if desired. The app keeps a full history of all exchanges for future reference.
- **Notes and Details:** Record detailed information about each stamp and collection.
- **Interactive dashboard:** View statistics and summaries through charts and indicators, with advanced filters by Category, Collection, and Country. Allows for personalized analysis of your collection data.
---
## 📊 Dashboard
The dashboard page provides an overview of your stamp collection, displaying metrics such as:
- Total number of stamps, collections, categories, and exchanges;
- Pie charts for stamps by category, by collection, and by country;
- Exchange activity over the last 12 months.
**Filtering options:**
Use the filters at the top of the dashboard to display data according to:
- **Category**: Shows only stamps from the selected category.
- **Collection**: Filters statistics for a specific collection.
- **Country**: Allows viewing only stamps from a particular country.
After choosing your desired filters, tap **"Apply filters"** to update the charts and indicators. To return to the global view, simply use the **"Clear filters"** option.
---
## 🔄 About Registering Exchanges
The app allows you to register stamp exchanges with other collectors easily:
1. **Select a stamp marked as available for exchange.**
2. **Enter the collector's information** (name, contact and transaction date) and add notes about the exchange if you wish.
3. **Register the exchange:** The stamp will be removed from your collection, and the exchange will be added to your history.
4. **Exchange history:** Review all exchanges in a dedicated section of the app, with details such as date, collector name, contact, and notes.
5. **Tip:** After registering an exchange, if you have not yet added the stamp received from the other collector, please do so to keep your collection up to date.
---
## 🚀 Technologies
- [.NET MAUI](https://learn.microsoft.com/dotnet/maui/) (.NET 8)
- SQLite (local storage)
- CommunityToolkit.Mvvm (MVVM)
- Pixabay API (image search)
- C#
---
## 📱 Supported Platforms
- Android
- iOS
- Windows
- Mac Catalyst
---
## 🌐 Localization
This application supports both Portuguese and English languages. You can switch the language in the Dashboard page or according to your system preferences.
- **Portuguese**: Fully translated user interface.
- **English**: Fully translated user interface.
#### If you'd like to contribute translations or suggest improvements, feel free to open an issue or pull request!
---
## 🛠️ How to run
1. **Clone the repository:**
```sh
git clone https://github.com/fauxtix/StampCollectorApp.git
cd StampCollectorApp
```
2. **Open in Visual Studio 2022 or newer.**
3. **Restore NuGet packages:**
- Visual Studio does this automatically when opening the solution.
4. **Select the desired platform (Android, Windows, etc) and run (F5).**
---
## 📂 Project Structure
```
StampCollectorApp/
├── Models/ # Data models (Stamp, Collection, Category, etc)
├── ViewModels/ # Presentation logic (MVVM)
├── Views/ # XAML pages
├── Services/ # Data services and integrations
├── Resources/ # Images, styles, etc
├── AppShell.xaml # Main navigation
├── MauiProgram.cs # DI configuration and initialization
└── ...
```
---
## 📝 Contributing
Contributions are welcome!
Open an issue or submit a pull request.
---
## 📄 License
This project is licensed under the MIT license.
---
## 📷 Screenshots
---
## 🤝 Contact
Questions or suggestions?
Open an issue please.