Skip to content

docs: add SCSS, Less and Stylus language pages#999

Merged
hatemhosny merged 3 commits into
live-codes:developfrom
Posterfo:docs/css-preprocessor-langs
Jun 28, 2026
Merged

docs: add SCSS, Less and Stylus language pages#999
hatemhosny merged 3 commits into
live-codes:developfrom
Posterfo:docs/css-preprocessor-langs

Conversation

@Posterfo

@Posterfo Posterfo commented Jun 23, 2026

Copy link
Copy Markdown
Contributor

What type of PR is this? (check all applicable)

  • ✨ Feature
  • 🐛 Bug Fix
  • 📝 Documentation Update
  • 🎨 Style
  • ♻️ Code Refactor
  • 🔥 Performance Improvements
  • ✅ Test
  • 🤖 Build
  • 🔁 CI
  • 📦 Chore (Release)
  • ⏩ Revert
  • 🌐 Internationalization / Translation

Description

Related Tickets & Documents

Mobile & Desktop Screenshots/Recordings

Added tests?

  • 👍 yes
  • 🙅 no, because they aren't needed
  • 🙋 no, because I need help

Added to documentations?

  • 📓 docs (./docs)
  • 📕 storybook (./storybook)
  • 📜 README.md
  • 🙅 no documentation needed

[optional] Are there any post-deployment tasks we need to perform?

[optional] What gif best describes this PR or how it makes you feel?

Summary by CodeRabbit

  • Documentation
    • Expanded the Less documentation from a placeholder into a complete page with an interactive demo, compilation behavior, external stylesheet importing guidance, compiler/version details, custom settings examples, code formatting recommendations, and links to official resources.
    • Expanded the SCSS documentation similarly with an interactive demo, @use/@import/dynamic loading guidance, Dart Sass compiler/version details, custom settings examples, formatting guidance, and links.
    • Expanded the Stylus documentation similarly with an interactive demo, @import guidance, compiler/version details, notes on formatting support, and links.
    • Updated Sass documentation to include the Dart Sass version and cleaned up a minor formatting note.

@netlify

netlify Bot commented Jun 23, 2026

Copy link
Copy Markdown

Deploy Preview for livecodes ready!

Name Link
🔨 Latest commit 4772221
🔍 Latest deploy log https://app.netlify.com/projects/livecodes/deploys/6a417f4005fc3100084d50d4
😎 Deploy Preview https://deploy-preview-999--livecodes.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

@coderabbitai

coderabbitai Bot commented Jun 23, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: 81c08831-40f0-433e-9b28-40b36948e084

📥 Commits

Reviewing files that changed from the base of the PR and between 9261ff0 and 9a839ce.

📒 Files selected for processing (4)
  • docs/docs/languages/less.mdx
  • docs/docs/languages/sass.mdx
  • docs/docs/languages/scss.mdx
  • docs/docs/languages/stylus.mdx
✅ Files skipped from review due to trivial changes (1)
  • docs/docs/languages/sass.mdx
🚧 Files skipped from review as they are similar to previous changes (3)
  • docs/docs/languages/less.mdx
  • docs/docs/languages/scss.mdx
  • docs/docs/languages/stylus.mdx

Walkthrough

Three CSS preprocessor docs pages are expanded from placeholders into full MDX documentation with live demos and reference sections. The Sass docs page also gains a compiler version note and a formatting cleanup.

Changes

CSS Preprocessor Language Documentation

Layer / File(s) Summary
Less language documentation
docs/docs/languages/less.mdx
Replaces the Less placeholder with full docs: exports lessConfig, adds Usage, @import loading, Language Info, Less.js compiler settings, code formatting guidance, and links.
SCSS language documentation
docs/docs/languages/scss.mdx
Replaces the SCSS placeholder with full docs: exports scssConfig, adds Usage, Loading External Styles (@use, @import, meta.load-css()), Language Info, Dart Sass compiler settings, code formatting guidance, and links.
Stylus language documentation
docs/docs/languages/stylus.mdx
Replaces the Stylus placeholder with full docs: exports stylusConfig, adds Usage, @import loading, Language Info, compiler details, code formatting guidance, and links.
Sass compiler version note
docs/docs/languages/sass.mdx
Adds a Sass compiler version subsection and removes trailing whitespace from the code formatting note.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~5 minutes

Possibly related PRs

  • live-codes/livecodes#953: Also changes docs/docs/languages/sass.mdx, so it overlaps at the same docs page and compiler/version area.
  • live-codes/livecodes#954: Touches the same Sass docs file, with changes in the same documentation surface.
🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately summarizes the main change: adding SCSS, Less, and Stylus documentation pages.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@pullfrog pullfrog Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

✅ No new issues found.

Reviewed changes — 3 new language documentation pages for Less, SCSS, and Stylus, replacing TODO... placeholders with complete content following the existing sass.mdx template.

  • New less.mdx page — covers Less syntax, @import for external styles, Less.js compiler, custom settings via the less config property, and Prettier formatting.
  • New scss.mdx page — covers SCSS syntax, @use/@import/meta.load-css() for external styles, Dart Sass compiler, custom settings via the scss config property, Prettier formatting, and a cross-link to sass.mdx.
  • New stylus.mdx page — covers Stylus flexible syntax, @import for external styles, Stylus compiler, notes that Prettier code formatting is not available for Stylus.

Pullfrog  | View workflow run | Using DeepSeek Pro (free via Pullfrog for OSS) | 𝕏

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@docs/docs/languages/scss.mdx`:
- Around line 119-120: The meta.load-css() example URL uses an incorrect GitHub
raw content path format with /refs/heads/develop/ which will fail when users
execute the code snippet. Fix the URL by replacing the /refs/heads/develop/
segment with the correct raw content format where develop is the branch name in
the standard raw.githubusercontent.com path structure. The corrected URL should
point directly to the raw file content on the develop branch without the
/refs/heads/ intermediary path.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: ee97d148-facd-436d-821f-c9c193a854ed

📥 Commits

Reviewing files that changed from the base of the PR and between 1d722a9 and 9261ff0.

📒 Files selected for processing (3)
  • docs/docs/languages/less.mdx
  • docs/docs/languages/scss.mdx
  • docs/docs/languages/stylus.mdx

Comment on lines +119 to +120
'https://raw.githubusercontent.com/live-codes/livecodes/refs/heads/develop/src/livecodes/styles/app.scss'
);

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

Fix the meta.load-css() example URL format.

At Line 119, the raw GitHub URL uses /refs/heads/develop/, which is not the direct raw-content path format and will likely fail when users try the snippet.

Proposed fix
 `@include` meta.load-css(
-  'https://raw.githubusercontent.com/live-codes/livecodes/refs/heads/develop/src/livecodes/styles/app.scss'
+  'https://raw.githubusercontent.com/live-codes/livecodes/develop/src/livecodes/styles/app.scss'
 );
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
'https://raw.githubusercontent.com/live-codes/livecodes/refs/heads/develop/src/livecodes/styles/app.scss'
);
`@include` meta.load-css(
'https://raw.githubusercontent.com/live-codes/livecodes/develop/src/livecodes/styles/app.scss'
);
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@docs/docs/languages/scss.mdx` around lines 119 - 120, The meta.load-css()
example URL uses an incorrect GitHub raw content path format with
/refs/heads/develop/ which will fail when users execute the code snippet. Fix
the URL by replacing the /refs/heads/develop/ segment with the correct raw
content format where develop is the branch name in the standard
raw.githubusercontent.com path structure. The corrected URL should point
directly to the raw file content on the develop branch without the /refs/heads/
intermediary path.

@hatemhosny

Copy link
Copy Markdown
Collaborator

Thank you @Posterfo
That's very nice indeed.

I made some minor edits to add compiler versions.

Keep up the great contributions ❤️

@hatemhosny hatemhosny enabled auto-merge June 28, 2026 19:53

@pullfrog pullfrog Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

✅ No new issues found.

Reviewed changes — the latest commit adds compiler version sections to the new CSS preprocessor docs and cleans up two formatting notes.

  • Added ### Version subsections to less.mdx, scss.mdx, stylus.mdx, and sass.mdx, listing the versions shipped by @live-codes/browser-compilers@0.22.10 (less 4.4.2, sass/Dart Sass 1.93.3, stylus 0.54.5).
  • Cleaned up formatting notes in sass.mdx and stylus.mdx (removed trailing whitespace and shortened the Stylus formatting sentence).

Pullfrog  | View workflow run | Using Kimi K2 (free via Pullfrog for OSS) | 𝕏

@hatemhosny hatemhosny merged commit 39335a5 into live-codes:develop Jun 28, 2026
17 checks passed
@sonarqubecloud

Copy link
Copy Markdown

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants