Skip to content
Manoela Ilic edited this page Dec 2, 2025 · 5 revisions

How to write a great Codrops tutorial

Style

  • Write clearly and conversationally — focus on teaching, not selling.
  • Blend creativity with technical depth: connect design ideas to implementation choices.
  • Share your reasoning and process, not just the end result.
  • Keep the tone friendly, approachable, and professional.

Structure

1. Introduction

Explain what the tutorial covers, why it’s interesting, and what tools or techniques you’ll be using. Set expectations and spark curiosity.

2. Concept

Provide a short background or design inspiration that grounds the idea. This helps readers understand the “why” before diving into the “how.”

3. Implementation

Walk through the build step by step:

  • Use concise, focused code snippets.
  • Prefer plain JavaScript or minimal dependencies unless something else is required.
  • Explain the logic behind the code or technique.
  • Emphasize clarity and replicability.

4. Refinement

Cover the details that make the project production-ready:

  • Responsiveness
  • Performance considerations
  • Code organization or structuring tips
  • Design polish and interaction details

5. Accessibility

Address relevant accessibility considerations such as reduced motion preferences, color contrast, input alternatives, or semantic structure.

6. Wrap-Up

Summarize what the reader learned, show the final result, and link to demos, resources, or your author profile.

Writing Approach

  • Keep snippets small and tightly focused.
  • Explain why and how, not just what.
  • Encourage experimentation, customization, and creative exploration.

Tone

  • Clear, confident, and instructive. But be yourself.
  • Technically accurate while still highlighting creative possibilities.

Further Inspiration

Browse more Codrops tutorials:
https://tympanus.net/codrops/category/tutorials/

This is just a guide, feel free to adjust to your specific case, every tutorial is unique!

Clone this wiki locally