Skip to content

danielkosgei/the-livingtree

Repository files navigation

🌳 The LivingTree

A modern, interactive family tree visualization tool
Create, share, and explore your family history with ease

License: MIT

Development Status Stability

The LivingTree is currently in very early development. Expect:

  • Breaking changes without notice
  • Incomplete documentation
  • Missing features and components
  • Bugs and unexpected behavior

Feel free to experiment and provide feedback

The LivingTree Demo

Features

Interactive Visualization

  • Beautiful, modern interface built with SvelteKit and svelteflow
  • Smooth, intuitive drag-and-drop interaction
  • Automatic layout and spacing of family members
  • Minimap for easy navigation of large trees
  • Zoom and pan controls for detailed exploration

Rich Family Relationships

  • Support for multiple marriages/partnerships
  • Visual distinction between current and previous marriages
  • Track marriage years, divorce years, and living status
  • Automatic parent-child relationship management
  • Visual indicators for biological and step-parent relationships

Real-time Editing

  • Click-to-edit any family member's details
  • Add new family members with a single click
  • Add spouses and children seamlessly
  • Automatic updates to family connections
  • Instant visual feedback for all changes

Data Management

  • Automatic saving to local storage
  • Export family tree as JSON
  • Import existing family trees
  • Share trees
  • Start fresh or use example family tree

Visual Design

  • Clean, modern user interface
  • Distinct colors for different relationship types
  • Dashed lines for previous marriages
  • Pink lines for step-parent relationships
  • Responsive design for all screen sizes

Technical Features

  • Built with modern web technologies
  • TypeScript for type safety
  • Efficient data compression for sharing
  • Modular component architecture
  • Open-source and extensible

Getting Started

Installation

"Families grow branch by branch, and so does this project."

How to Help (Even Without Code)

1. Improve Documentation

  • Fix typos in our guides
  • Translate materials to other languages

2. Spread the Word

  • Star ⭐ this repository
  • Share project goals with genealogy communities
  • Document your testing process (blog/video)

For Technical Contributors

1. Fork the Repository

  1. Click Fork at top-right of the-livingtree repo
  2. Clone your fork:
    # Remember to replace yourusername with your github username
    git clone https://github.com/yourusername/the-livingtree.git && cd the-livingtree
  3. Create a Feature Branch
    # feature/your-feature-name
    git checkout -b feature/your-feature-name # or fix/your-fix-name
  4. Push to your fork
    # Commit your code with a descriptive commit message before pushing
    git push origin feat/your-feature-name
  5. Open a Pull Request (PR)

Tech Stack

  • SvelteKit
  • Visualization: @xyflow/svelte, D3

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

Contact

If you have any questions or suggestions, please open an issue on GitHub.

About

A growing archive of your family's journey, shaped by the people who live it.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Contributors