Contribution Roadmap - satoshi-create/emakimono-next GitHub Wiki

🌐 Contribution Pathways

Phase Ideal Tasks for Contributors Label
Phase 1 Refactoring, TS migration refactor, typescript
Phase 2 Schema design, Supabase integration data, schema
Phase 3 UI/UX, map integration ux, gis, feature
Phase 4 Translation, docs, i18n i18n, docs, global

Issue numbers and labels are examples—please adapt to your project.

🗀 Development Roadmap

Phase 1: Refactor OSS Foundation

journey
  section Phase 1 OSS Infrastructure Refactoring
    Upgrade from Next.js 12 to latest version: 4:Developers
    Introduce TypeScript with explicit type definitions: 3:Developers
    Migrate to Tailwind CSS: 3:Developers
    Restructure components and project folders: 3:Developers
  • Goal: Clean up legacy code and establish a scalable, contributor-friendly base.
  • Examples:
    • Upgrade to the latest Next.js (ready for App Router)
    • Enforce type safety with TypeScript
    • Consistent styling via Tailwind CSS
    • Modular folder structure for better maintainability

Phase 2: Redesign Data Architecture

journey
  section Phase 2 Data Structure Redesign
    Migrate from JSON to RDB (e.g. Supabase): 4:Developers
    Design schema using Prisma/Zod: 3:Developers
    Integrate image and text metadata management: 3:Developers
  • Goal: Shift from static JSON to a reusable, scalable relational structure.
  • Examples:
    • Use Supabase or similar RDB for structured storage
    • Define schemas with Prisma and Zod
    • Unified handling of image metadata and text content

Phase 3: Build Interactive UX

journey
  section Phase 3 Interactive UX Enhancements
    Add thumbnail navigation and scroll position tracking: 4:UX Team
    Visualize current position and scroll direction: 4:UX Team
    Connect with GIS maps for location-based access: 3:Frontend/Geospatial Team
    Model inter-scroll relationships (theme, geography, era): 3:AI/Cultural Team
  • Goal: Transform the viewing experience into a more explorative, user-driven flow.
  • Examples:
    • Thumbnail-based navigation and scroll tracking
    • Mobile optimization and direction-aware UX
    • GIS-based access to scrolls
    • Scroll-to-scroll network visualization based on story, location, or theme

Phase 4: International & Cultural Expansion

journey
  section Phase 4 Internationalization & Cultural Networks
    Implement i18n using next-i18next: 3:Translators
    Translate README/Wiki and improve outreach: 3:All Contributors
    Publish project site via GitHub Pages: 2:All Contributors
    Link with uta-makura, shrines, and linked-verse networks: 2:Cultural Researchers
  • Goal: Share Japan's cultural heritage with the world and integrate related systems.
  • Examples:
    • Multilingual interface via next-i18next
    • Translate documentation and increase contributor diversity
    • Deploy GitHub Pages for global exposure
    • Cultural integration with uta-makura, shrines, and linked poetry