Troubleshooting

Troubleshooting

Debugging common issues with build errors, runtime errors, and deployment problems in Manic.

Troubleshooting

TL;DR

Solutions to common issues you may encounter when building, running, and deploying Manic applications.

This section covers common problems and their solutions organized by category.

What's Inside

Build Errors

Linting, TypeScript, bundling, and compilation issues.

Deployment Errors

Platform-specific deployment and runtime issues.

Quick Debugging Checklist

Before diving into specific errors, try these general fixes:

Restart the Development Server

Stop and restart the dev server to clear cached state:

# Stop server (Ctrl+C)
# Then restart
bun dev

Clear Build Cache

Remove the .manic cache directory:

rm -rf .manic
bun build

Check Dependencies

Ensure all dependencies are installed:

bun install

Enable Debug Logging

Run with debug output:

DEBUG=manic:* bun dev

Common Categories

Build Issues

  • Linting errors
  • TypeScript errors
  • Bundling failures
  • Configuration problems

Runtime Issues

  • Route not found
  • API errors
  • Hot reload not working

Deployment Issues

  • Platform-specific errors
  • Environment configuration
  • Build output problems

Getting Help

If you can't find your issue here:

  1. Check the GitHub Issues
  2. Search the Discussions
  3. Create a minimal reproduction

See also:

Testing

Unit and integration tests with Bun's built-in runner (bun test, bun:test); end-to-end tests with Playwright.

Build Errors

Debugging linting, TypeScript, bundling, and compilation errors in Manic.

On this page

Troubleshooting
What's Inside
Quick Debugging Checklist
Restart the Development Server
Clear Build Cache
Check Dependencies
Enable Debug Logging
Common Categories
Build Issues
Runtime Issues
Deployment Issues
Getting Help