Skip to content

About

A helper for visually debugging styles in CSS-in-JS

Resources

Stars

130 stars

Watchers

2 watching

Forks

Latest commit

 

History

40 Commits

Folders and files

Repository files navigation

styles-debugger

A helper for visually debugging styles in CSS-in-JS

Kitze Made by Kitze
kitze.io · X · YouTube


More projects by Kitze

pwn.watch logo
pwn.watch
Live security incidents: CVEs, patch status, fixed versions and advisories.
flavors.design logo
flavors.design
Copy-pasteable design flavors. Pick a vibe, hand the markdown to your agent.
gifs.so logo
gifs.so
Search, copy, and download reaction GIFs.
Shipper logo
Shipper
Changelog, roadmap, feature requests and tasks for every product you ship.
Kanso logo
Kanso
One keyboard-first app for your todos, habits, routines, planner and saved stuff.
HealthMaxx logo
HealthMaxx
One health log for everything you track: by hand, from wearables, or through your AI.
Zero To Shipped logo
Zero To Shipped
A full-stack starter kit for web and mobile apps.
Sotto logo
Sotto
Voice-to-text for macOS. Local AI, one-time purchase.
Tinkerer Club logo
Tinkerer Club
A private community for builders, self-hosters, and AI tinkerers.
Sizzy logo
Sizzy
The browser for web developers.
Supermac logo
Supermac
A macOS command center for everyday workflows.
DMX logo
DMX
A focused desktop client for X.

Support this project

Buy me a coffee   Sponsor on GitHub

Sponsors

Matte logo
Matte
3D mockups and screen recordings with pro-level video editing
Postiz logo
Postiz
Agentic social scheduler for GIFs!
ScreenshotOne logo
ScreenshotOne
The best screenshot API for developers and agents
ether.fi logo
ether.fi
a neobank with a built in ai-connector, build your own frontend to your finance with claude, chatgpt or your LLM of choice! Feedback always welcome!
OpenProse logo
OpenProse
Reliable, event-driven multiagent workflows — in Markdown.
OpenTweet logo
OpenTweet
Agentic X (Twitter) autopilot.
AppSumo logo
AppSumo
1M+ entrepreneurs use AppSumo to find the best deals on software for their business. One-time payments, lifetime access.
Team Spartan by CONFLICT logo
Team Spartan by CONFLICT
Know what matters. Get it fixed. Experience spans high-traffic consumer platforms, cloud infrastructure, and security — built under real operational pressure.
Browserless.io logo
Browserless.io
The web layer your agent runs on.
Strix logo
Strix
Hack yourself before the bad guys do. Open source (70k+ stars on Github)
Maple VC logo
Maple VC
We're 3 operators (digitalocean, uber, shopify) turned investors who write first checks into folks with ambition to build global businesses.
Rakazo logo
Rakazo
Open source Grok Bot
The Influencer AI logo
The Influencer AI
AI influencer generator: create a realistic influencer from traits or your photos, then make photos, talking videos and UGC ads with the same face every time.
Pluginboard logo
Pluginboard
Find the right plugins for your AI agents. Plugins, skills and step-by-step recipes for Claude, ChatGPT, Grokbot, Muse, Gemini and more.
file.cafe logo
file.cafe
Free, instant file sharing.
LinkDR logo
LinkDR
Link building that works: real backlinks from hundreds of high-DR sites, done for you or self-serve.
Outmano logo
Outmano
AI agents that watch your competitors so you don't have to
Mixpost logo
Mixpost
Self-hosted social media scheduler. Pay once.
Synteq logo
Synteq
The cloud, built for developers.
Kraken.io logo
Kraken.io
We optimize your images, to save you bandwidth, make your websites faster, make your customers less frustrated, and reduce your CDN costs.
Open Source Alternatives logo
Open Source Alternatives
Best Open Source Alternatives to Paid Software. Type anything and It answers with the right open source alternatives.
WATASU logo
WATASU
Hosting for your vibe-coded app
Your product here
Reach developers in every kitze repo.



🙋‍♂️ Made by @thekitze

Other projects:

  • 🏫 React Academy - Interactive React and GraphQL workshops
  • 💌 Twizzy - A standalone app for Twitter DM
  • 💻 Sizzy - A tool for testing responsive design on multiple devices at once
  • 🤖 JSUI - A powerful UI toolkit for managing JavaScript apps

Zero To Shipped


Styles Debugger

A helper for visually debugging css-in-js styles.

  • Works both with template literals and objects.
  • It also works with inline styles but it won't show any text.

Made by Kitze

Install

yarn add styles-debugger

Demos

Basic usage

With template literals

import { debug } from 'styles-debugger';
import styled from 'styled-components';

const Header = styled.div`
  ${debug()};
`;

With objects

import { debug } from 'styles-debugger';
import emotion from 'react-emotion';

const Header = emotion('div')({
  ...debug()
});

Show text along the border

const Wrapper = styled.div`
  ${debug('Wrapper')};
`;

Show text + customize options

const Footer = styled.div`
  ${debug('Footer', { color: 'blue', debugWith: 'background' })};
`;

Available params for debug

debug(text: String, params: Object)

Each debug function call can override the default params object for the debugger with a custom object. So for example if for some element you would like to use specific options for debugging you can just pass them as the params parameter. See the available options.

Initialize custom instance

Instead of using the default debug function you can create your own debugger. Initialize it in some file and customize it the way you want.

import { CreateStylesDebugger } from 'styles-debugger';

const debug = CreateStylesDebugger({
  color: 'blue',
  borderSize: 3,
  position: 2,
  styles: {
    text: {
      color: 'red'
    }
  },
  debugWith: 'background'
});

export default debug;

Configuration options

  • enabled: if this is set to false debug mode will be turned off for all the components (default is true)
  • position: pick the corner position for the text: options are 1 | 2 | 3 | 4 (default is 1)
  • color: which should be a default color for the border of the element (by default it's a random color)
  • debugWith: what should be used for debugging the elements: border or background (default is border)
  • borderSize: if using border for debugging, specify the size of the border (default is 1)
  • showText: enable or disable showing text with pseudo elements for each component (default is true)
  • pseudoElement: which pseudo element to be used: after or before
  • styles: an object that can be passed to completely override the styles for element (the element that is debugged), and text (the pseudo element with the text).

More projects by Kitze

Apps & tools

Perkz
Sell and manage access to private GitHub repositories.
JustWrite
Distraction-free writing sprints for macOS, with time or word-count goals.
Releaseflow
App updates and downloads.
Passlock
A macOS password manager with time locks and unlock challenges.

Open source

Skillbox
A self-hosted, versioned skills library for AI agents.
Unclutter
Remove page clutter with AI-powered, reusable browser rules.
PageGrade
Grade page clarity, writing, and on-page SEO.
Council
Let your coding agents deliberate together before making a plan.
CodexMaxx
Manage Codex accounts, usage, and active sessions on macOS.
React Hanger
A collection of useful React hooks.
React Genie
Animate React elements as they enter the viewport.
MobX Router
A simple router for MobX and React apps.

All projects · GitHub · Follow on X · YouTube

About

A helper for visually debugging styles in CSS-in-JS

Resources

Stars

130 stars

Watchers

2 watching

Forks

Releases

Packages

Used by

Contributors

Languages