MCPcopy Index your code
hub / github.com/ZhengJiawen44/tatsu

github.com/ZhengJiawen44/tatsu @main

Chat with this repo
repository ↗ · DeepWiki ↗ · + Follow
670 symbols 2,167 edges 399 files 0 documented · 0%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

CI Tests CodeFactor License TypeScript Last Commit contributions welcome

Tatsu - The Ultimate Todo App

hero demo video

1. Introduction

Tatsu is a todo app on steroids, designed to keep you motivated and productive.

2. Features

  1. Natural Language Processing
    Automatically extracts dates, times, and durations from your input. Just type naturally and the system handles the rest.

  2. Calendar View
    View all your tasks at a glance with monthly, weekly, and daily layouts to stay organized.

  3. Two way caldendar Sync

all synced objects from external caldav servers are treated as first class citizens in Tatsu, this means that you can do everything you already can to synced objects like any other todos. Many todo implementations restrict what you can do with synced objects. Tatsu strives to blend the differences to offer a more seamless experience. (this part looks like AI but it is infact written by me)

  1. Notion-like Editor
    A powerful and intuitive editor for structured note-taking and task management.

  2. End-to-End Encrypted File Uploads
    Securely upload and manage files with full end-to-end encryption to protect your data.

More exciting features coming soon!!

3. Documentation

https://sanity.my/en/blogs

4. RoadMap

https://github.com/ZhengJiawen44/tatsu/wiki/Roadmap

5. Deploying with Docker

  1. Download the docker-compose.yml file from this repository.

  2. Copy .env.example to .env and fill in the required values.

  3. Start the containers:

docker compose up -d

This will: - Pull the latest prebuilt image from GitHub Container Registry. - Start a Postgres database (postgres:15) with persistent storage. - Run Prisma migrations automatically on startup.

Once running, the app will be available at http://localhost:3000.

To stop the containers:

docker compose down

6. Local Development with Docker

you get: 1. hot module refresh. 2. prisma server on localhost:5555 3. dev server on localhost:3000 4. postgres server on postgres port 5432

you do: 1. Git clone this repository 2. Copy .env.example to .env and fill in the required values. 3. start the dev server docker compose -f docker-compose.dev.yml up 4. make edits to the code base and see changes in real time.

To stop the dev server docker compose -f docker-compose.dev.yml down

7. Running Locally without Docker

this guide is too long, it is moved to tatsu wiki

8. Fonts

This project uses next/font for optimized font loading. It features Poppins, a modern and elegant font from Google.

Extension points exported contracts — how you extend this code

RegisterFormProp (Interface)
(no doc)
types.ts
User (Interface)
(no doc)
types/next-auth.d.ts
Props (Interface)
(no doc)
components/ErrorBoundary.tsx
TodoFormContainerProps (Interface)
(no doc)
components/todo/component/TodoForm/TodoFormContainer.tsx
MenuItemType (Interface)
(no doc)
components/ui/Menu.tsx
TodoFormContextType (Interface)
(no doc)
providers/TodoFormProvider.tsx
NotificationProviderContextProps (Interface)
(no doc)
providers/NotificationProvider.tsx
passKeyContextProp (Interface)
(no doc)
providers/PassKeyProvider.tsx

Core symbols most depended-on inside this repo

cn
called by 87
lib/utils.ts
toast
called by 84
hooks/use-toast.ts
useToast
called by 63
hooks/use-toast.ts
errorHandler
called by 20
lib/errorHandler.ts
generateTodosFromRRule
called by 20
lib/RRule/generateTodosFromRRule.ts
getTodayBoundaries
called by 19
tests/lib/getTodayBoundaries.ts
withRRule
called by 19
tests/lib/todoBuilder.ts
withdtstart
called by 19
tests/lib/todoBuilder.ts

Shape

Function 594
Interface 40
Method 20
Class 16

Languages

TypeScript100%

Modules by API surface

lib/customError.ts18 symbols
components/ui/icon/fonts.tsx14 symbols
components/todo/component/TodoForm/NLPTitleInput.tsx14 symbols
tests/lib/todoBuilder.ts12 symbols
components/ui/Modal.tsx10 symbols
types.ts9 symbols
hooks/use-toast.ts9 symbols
components/ErrorBoundary.tsx8 symbols
lib/sync/parseIcsDataToLocal.ts6 symbols
features/calendar/component/CalendarForm/FormFields/Dropdowns/DateDropdown/DateDropdownMenu.tsx6 symbols
components/ui/carousel.tsx6 symbols
providers/UserPreferencesProvider.tsx5 symbols

Datastores touched

dummyDatabase · 1 repos

For agents

$ claude mcp add tatsu \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page