Home ci 08. projects: project configuration

08. projects: project configuration

Last updated on Aug 05, 2025

To effectively configure redirects, rewrites, and headers in your Epycbyte setup, follow these organized steps:

  1. Redirection Setup:

    • Use redirects for temporary URL changes or when you want the client to recognize the change (307 status).
    • Example: Redirect "/posts/:id" to "/blog/:id" temporarily.
  2. Rewrite Configuration:

    • Utilize rewrites for dynamic content where the URL structure needs modification without altering the resource.
    • Example: Serve all unmatched paths with "/index.html" for SPAs.
  3. Header Application:

    • Add headers to enhance caching, security, or other HTTP attributes.
    • Example: Set Cache-Control for favicon.ico and static assets.
  4. Regex Handling:

    • In routes, escape dots to avoid unintended character matching.
    • Use rewrites without escaping dots for precise regex patterns.
  5. Negative Lookaheads:

    • Implement negative lookaheads in routes to prevent infinite loops, redirecting only specific paths like "/maintenance".
  6. Case Sensitivity:

    • Use rewrites or redirects instead of routes to avoid case-insensitive matching issues, ensuring unique URLs and SEO-friendly practices.
  7. Order of Processing:

    • Epycbyte processes redirects before rewrites.
    • Headers are applied by default unless specified otherwise.
  8. Testing and Validation:

    • Test each configuration individually, starting with simple redirects and gradually adding complexity.
    • Ensure headers don't interfere with existing configurations.