Skip to main content

Quick Start Guide

Welcome to AniDojo! This guide will walk you through creating your account, setting up your profile, and adding your first anime to your list.
AniDojo is a web-based platform accessible at your deployment URL. No installation required for users!

Getting Started

1

Create Your Account

Sign Up for AniDojo

  1. Navigate to the AniDojo homepage
  2. Click “Create Account” button on the landing page
  3. Enter your email address and create a secure password
  4. Click “Sign Up” to create your account
Your profile will be automatically created with a username based on your email. You can customize it later!
What Happens Next:
  • A profile is automatically created in the database (via the handle_new_user() trigger)
  • Your user ID is stored in the profiles table
  • You’re redirected to the dashboard
-- Automatically creates profile on signup
CREATE TRIGGER on_auth_user_created
  AFTER INSERT ON auth.users
  FOR EACH ROW EXECUTE FUNCTION handle_new_user();
2

Explore Your Dashboard

Welcome to Your Dashboard

After signing in, you’ll see your personalized dashboard at /dashboard with:
  • Recommended Anime: AI-powered recommendations based on your taste
  • Trending This Week: Popular anime in the community
  • Current Season: Ongoing seasonal anime
  • Community Reviews: Latest reviews from other users
Navigation Menu (left sidebar):
  • Home (Dashboard)
  • Search
  • AI Recommender
  • My Lists
  • My Reviews
  • Upcoming
  • Profile
  • Settings
The dashboard uses the Jikan API to fetch real anime data from MyAnimeList. Initial load may take a moment.
3

Search for Anime

Find Your Favorite Anime

Option 1: Use Global Search
  • Click the search bar in the top navigation
  • Type the anime title (e.g., “Attack on Titan”)
  • Select from the dropdown results
Option 2: Browse Top Anime
  • Navigate to Search in the sidebar
  • Browse through top-rated anime from MyAnimeList
  • Use pagination to explore more titles
Option 3: Discover Recommendations
  • Click AI Recommender in the sidebar
  • Answer questions about your preferences
  • Get personalized anime suggestions
// AniDojo searches the Jikan API
const results = await searchAnime('demon slayer', 1, 20);

// Returns MyAnimeList data
{
  data: [
    {
      mal_id: 38000,
      title: "Demon Slayer: Kimetsu no Yaiba",
      title_english: "Demon Slayer: Kimetsu no Yaiba",
      images: { jpg: { large_image_url: "..." } },
      score: 8.52,
      genres: [{ name: "Action" }, { name: "Adventure" }]
    }
  ]
}
4

Add Anime to Your List

Create Your First Entry

Once you’ve found an anime:
  1. Click on the anime card to view details at /anime/[id]
  2. Click “Add to List” button
  3. Fill in the entry details:
    • Status: Watching, Completed, Plan to Watch, On Hold, or Dropped
    • Episodes Watched: Track your progress (e.g., 5/12)
    • Your Rating: Rate from 1-10 (optional)
    • Notes: Add personal notes (optional)
    • Tags: Add custom tags (optional)
    • Mark as Favorite: Star your favorites
  4. Click “Save” to add to your list
Your First Entry is Created!
// Database structure for your anime list
{
  id: "uuid",
  user_id: "your-user-id",
  anime_id: 38000,
  title: "Demon Slayer: Kimetsu no Yaiba",
  status: "watching",
  episodes_watched: 5,
  score: 9,
  favorite: true,
  tags: ["action", "must-watch"],
  notes: "Amazing animation quality!",
  created_at: "2024-03-15T10:30:00Z"
}
Row Level Security ensures only you can see and modify your list entries (unless you make lists public).
5

Manage Your Lists

View and Organize Your Anime

Navigate to My Lists in the sidebar to see all your anime:List Views:
  • Cards View: Visual grid with cover art
  • Table View: Detailed spreadsheet-style view
  • Compact View: Dense list for quick scanning
Filter by Status:
  • All anime
  • Watching (currently in progress)
  • Completed (finished series)
  • On Hold (paused)
  • Dropped (discontinued)
  • Plan to Watch (backlog)
Sort Options:
  • Title (A-Z or Z-A)
  • Score (High to Low or Low to High)
  • Date Added
  • Last Updated
  • Progress (% completed)
Quick Actions:
  • Quick Edit: Update status, episodes, or rating
  • Increment Episode: Mark next episode as watched (for ongoing series)
  • View Details: Go to anime details page
  • Delete Entry: Remove from your list
Use the Stats panel to see your total anime count, episodes watched, mean score, and favorite genres!
6

Write Your First Review

Share Your Thoughts

Ready to review an anime you’ve watched?
  1. Go to the anime details page (/anime/[id])
  2. Click “Write Review” button
  3. Fill in the review form: Multi-Dimensional Ratings:
    • Overall Rating (1-10)
    • Story Rating (1-10)
    • Animation Rating (1-10)
    • Sound Rating (1-10)
    • Character Rating (1-10)
    • Enjoyment Rating (1-10)
    Review Content:
    • Title: Catchy review headline
    • Body: Detailed review text
    • Pros: What you liked
    • Cons: What could be improved
    • Spoilers: Toggle if review contains spoilers
    • Watch Status: Completed, Watching, Dropped, or Plan to Watch
    • Recommendation: Highly Recommend → Strongly Not Recommend
  4. Choose “Save as Draft” or “Publish”
You can only have ONE published review per anime. Draft multiple versions and publish your favorite!
{
  id: "uuid",
  user_id: "your-user-id",
  anime_id: 38000,
  rating: 9,
  story_rating: 9,
  animation_rating: 10,
  sound_rating: 9,
  character_rating: 8,
  enjoyment_rating: 9,
  title: "A Visual Masterpiece",
  body: "Demon Slayer sets a new standard...",
  pros: "Stunning animation, great soundtrack",
  cons: "Story can be predictable at times",
  recommendation: "highly-recommend",
  status: "published",
  spoilers: false
}
7

Customize Your Profile

Make It Your Own

Navigate to Profile or Settings to customize:Profile Settings:
  • Username: Change your display name
  • Avatar: Upload a profile picture (stored in Supabase Storage avatars bucket)
  • Bio: Add a personal bio
Privacy Settings:
  • Make lists public or private
  • Control who can see your reviews
Avatar images are stored in Supabase Storage with Row Level Security. Only you can upload/update your avatar.

What’s Next?

Discover More Anime

Explore trending anime, current season releases, and use AI recommendations to find hidden gems.

Build Custom Lists

Create themed custom lists like “Best Action Anime” or “Must Watch Romance” and share with friends.

Engage with Community

Read and vote on reviews, leave comments, and discover what other fans are watching.

Track Statistics

Analyze your watching habits with detailed stats: genre distribution, score patterns, and viewing history.

Common User Flows

  1. Go to My Lists
  2. Find the anime you’re watching
  3. Click the + button to increment episodes watched by 1
  4. Or click Edit to manually set the episode count
When episodes watched equals total episodes, the status automatically changes to “Completed”!
Yes! AniDojo supports list import:
  1. Export your list from MyAnimeList as XML or JSON
  2. Go to My ListsImport
  3. Upload your file
  4. AniDojo will match anime by MAL ID and create entries
Note: The import feature uses the upsertAnimeEntry function to avoid duplicates.
  1. Go to Settings
  2. Under Privacy, toggle “Make Lists Public”
  3. Your lists will now be visible to other users on your profile page
Custom lists have individual public/private settings in the list creation modal.
Notes (in anime_entries table):
  • Private to you
  • Quick thoughts or reminders
  • Character limit: 500
  • Not visible to other users
Reviews (in reviews table):
  • Can be published publicly
  • Detailed with multi-dimensional ratings
  • Community can vote and comment
  • One published review per anime

Tips for New Users

Start Small: Add 5-10 anime you’ve already watched to get personalized recommendations working.
Use Tags: Add tags like “rewatch”, “favorite”, “binge-worthy” to organize your list effectively.
Rate Everything: The more you rate, the better your AI recommendations become!
Join the Community: Read reviews and leave comments to discover new perspectives on anime.

Troubleshooting

Can’t add anime to list?
  • Make sure you’re signed in
  • Check that you haven’t already added this anime (search in My Lists)
  • Try refreshing the page if the API is slow
Search not working?
  • The Jikan API has rate limits (3 requests/second)
  • Wait a few seconds and try again
  • Check your internet connection

Need More Help?

For detailed feature documentation, see:

Build docs developers (and LLMs) love