Skip to content

Paresh-0007/Mythos

 
 

Repository files navigation

✨ Mythos — Collaborative Storytelling & World-Building Platform

Mythos is a beautiful, pastel-themed full-stack web application that empowers writers to collaboratively build stories, characters, and immersive worlds. Designed for creators, by creators — Mythos provides real-time editing, version control, and narrative visualization tools to bring your stories to life.


🌟 Features

🏠 Interactive Landing Page

  • Hero section with animated showcase
  • Highlights core platform features and benefits

🔐 Authentication & Project Management

  • Secure user login/signup
  • Create, manage, and join writing projects
  • Role-based access for contributors and admins

✍️ Real-Time Collaborative Editor

  • Live editing with presence indicators
  • Inline comments, suggestions, and formatting tools
  • Framer Motion-powered transitions

🌍 World-Building System

  • Manage characters, locations, species, lore, and more
  • Tag relationships and references across documents

🌀 Narrative Version Control

  • Track revisions with version history
  • Compare and revert to previous drafts
  • Git-like branching for parallel story development

📈 Project Dashboard

  • Progress tracking and contribution metrics
  • Story and world-building analytics

🧭 Story Arc & Timeline Visualization

  • Drag-and-drop arcs and key events
  • Visual narrative planning tools

🎨 Design & UX

A soothing and intuitive interface to help you stay in the creative flow.

  • Color Palette:

    • Soft Pink #F8BBD9
    • Lavender #E8D5FF
    • Mint Green #B8F2E6
    • Peach #FFD3B6
  • UI Highlights:

    • Glassmorphism effects with smooth shadows
    • Framer Motion page transitions and interactions
    • Minimalist, readable typography
    • Responsive design for all devices
    • Micro-animations and interactive hover states

🛠️ Tech Stack

Frontend:

  • React + TypeScript
  • Next.js (optional SSR/SSG)
  • Tailwind CSS (custom pastel theme)
  • Framer Motion
  • Zustand or Redux for state management
  • Yjs or Liveblocks for real-time collaboration

Backend:

  • Node.js + Express or NestJS
  • MongoDB or PostgreSQL
  • Socket.IO / WebSockets for real-time updates
  • Git-like diffing/version control logic

Auth & Deployment:

  • Auth0 or Firebase Auth
  • Vercel / Netlify (Frontend)
  • Render / Heroku / Railway (Backend)

🚀 Getting Started

  1. Clone the repository:

    git clone https://github.com/your-username/mythos.git
    cd mythos
    
    
  2. Install dependencies:

    npm install
  3. Set up environment variables:

    • Create a .env.local file (see .env.example for required variables)
  4. Start the development server:

    npm run dev
  5. Backend setup:

    • Navigate to /server directory (if separate)

    • Follow similar install steps and run:

      npm run start

📂 Folder Structure (Simplified)

/client         # Frontend (React/Next.js)
/server         # Backend (Node/Nest)
/public         # Static assets
/shared         # Shared types/interfaces
.env.example    # Environment variable example

📌 Future Roadmap

  • AI-assisted writing prompts and suggestions
  • Custom themes and dark mode
  • Publishing tools (export to PDF, EPUB, HTML)
  • Plugin system for community extensions

🤝 Contributing

We welcome community contributions! Please fork the repo and submit a pull request. For major changes, open an issue first to discuss your idea.


🌐 Demo

Live Demo (coming soon)

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 71.3%
  • JavaScript 28.3%
  • Other 0.4%