🌸 Sakura Resale

A modern, open-source marketplace platform designed specifically for Japan. Built with modern web technologies and optimized for the Japanese market.

🚀 Features

• Multi-category Marketplace: Electronics, Vehicles, Real Estate, Fashion, and more
• Japanese Localization: Full Japanese language support with cultural considerations
• Mobile-First Design: Optimized for mobile users (essential in Japan)
• Advanced Search & Filtering: Location-based search, price ranges, condition filters
• Real-time Messaging: Direct communication between buyers and sellers
• User Ratings & Reviews: Build trust in the community
• Secure Payments: Integration with popular Japanese payment methods
• Image Optimization: Fast loading with CDN support

🛠 Tech Stack

• Frontend: Next.js 14 + React 18 + TypeScript
• Backend: Node.js + Express + TypeScript
• Database: PostgreSQL with Prisma ORM
• Authentication: NextAuth.js
• File Storage: AWS S3 + CloudFront CDN
• Hosting: AWS (ECS/Lambda + RDS + S3)
• Styling: Tailwind CSS + shadcn/ui
• Real-time: Socket.IO
• Testing: Jest + Cypress
• Deployment: Docker + GitHub Actions

🏗 Project Structure

sakura-resale/
├── frontend/          # Next.js frontend application
├── backend/           # Node.js API server
├── database/          # Database schemas and migrations
├── shared/            # Shared types and utilities
├── docs/              # Documentation
├── infra/             # AWS infrastructure as code
└── docker/            # Docker configurations

🚀 Quick Start

Prerequisites

• Node.js 18+ and npm
• PostgreSQL 14+
• AWS CLI (for deployment)
• Docker (optional, for containerized development)

Development Setup

1. Clone the repository

   git clone https://github.com/irshadawake/sakura-resale.git
   cd sakura-resale

2. Install dependencies

   # Install root dependencies
   npm install
   
   # Install frontend dependencies
   cd frontend && npm install && cd ..
   
   # Install backend dependencies
   cd backend && npm install && cd ..

3. Set up environment variables

   cp .env.example .env.local
   # Edit .env.local with your configuration

4. Start development servers

   # Start both frontend and backend
   npm run dev
   
   # Or start individually
   npm run dev:frontend  # http://localhost:3000
   npm run dev:backend   # http://localhost:8000

🌍 Japanese Market Considerations

• Mobile-First: Over 60% of Japanese users browse on mobile
• Payment Methods: Support for popular methods like PayPay, LINE Pay, etc.
• Address System: Japanese postal code and address formatting
• Cultural UX: Clean, minimalist design preferred in Japan
• Trust Features: Strong emphasis on user verification and reviews

📱 Screenshots

Coming soon...

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

📄 License

This project is open source and available under the MIT License.

🙏 Acknowledgments

• Inspired by successful Japanese marketplaces
• Built with love for the Japanese community
• Special thanks to all contributors

---

Made with 🌸 for Japan