Skip to content

datngw/Memoly

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Memoly

Turn every lifeless object into a living diary page with a smart management system.

Overview

Memoly is an app that lets you attach stories and memories to physical objects through QR codes. Every item — an old medal, a rare book, a keepsake — carries a story. Memoly helps you preserve and pass those stories on to yourself and future generations.

Architecture

Memoly Architecture

How It Works

  1. Register — Take a photo of the item, enter its details, and write the story behind it. You can also upload related old photographs.

    • Example: Photograph an old medal, label it "Dad's medal from 1995," and write its story.
  2. Generate Code — The app creates a QR code. You can print it as a sticker or save the file to print later.

  3. Tag — Stick the QR code onto the item or its container.

  4. Retrieve — Whenever you (or your descendants) pick up the item, simply open your phone camera and scan the code — the full story and vintage photos appear instantly.

Tech Stack

Backend

Component Technology
Runtime .NET 10, C# 14
Orchestration .NET Aspire
Reverse Proxy Traefik
API ASP.NET Core Minimal APIs
ORM EF Core
API Docs Scalar
Logging Serilog + Seq
Resilience Polly v8
Event Bus MassTransit (RabbitMQ)
CQRS MediatR
Validation FluentValidation
Mapping Mapster
Authentication OpenIddict
Testing xUnit v3, Fluent Assertions, Moq, Testcontainers
Code Quality SonarQube
Architecture Modular Monolith

Frontend

Component Technology
Framework React + Vite
State Zustand
UI Components shadcn/ui
Icons Lucide Icons
Styling Tailwind CSS

Getting Started

# Backend (via Aspire — starts API + all containers)
dotnet run --project src/Aspire/Memoly.AppHost

# Frontend
cd src/Frontend/memoly-web
npm install
npm run dev

License

Personal project — not for distribution.

About

Memoly is a digital story keeper that lets you register physical items, write their stories, and generate QR codes to attach to them. Scan the code later to relive the memory — preserving family heritage, one object at a time. Built with .NET 10, React, and .NET Aspire.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors