md-slides 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Deepankar Rawat
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,219 @@
+# @dprrwt/slides
+
+> Convert Markdown to beautiful presentation slides. Zero config, developer-friendly.
+
+Write your presentation in **Markdown**, present it in the **browser**, deploy it anywhere as **static HTML**.
+
+## ✨ Features
+
+- **Markdown-first** — Write slides in your editor, not a GUI
+- **4 built-in themes** — Dark, Light, Minimal, Neon
+- **Live preview** — Hot reload as you edit
+- **Keyboard navigation** — Arrow keys, vim keys, touch/swipe
+- **Speaker notes** — Hidden notes with toggle (press `S`)
+- **Code highlighting** — Syntax highlighting for 190+ languages
+- **Smart layouts** — Auto-detects title slides, code slides, quote slides
+- **Responsive** — Scales to any screen, including mobile
+- **Zero dependencies at runtime** — Output is a single HTML file
+- **Frontmatter** — Set title, author, theme per file
+
+## 📦 Install
+
+```bash
+npm install -g @dprrwt/slides
+```
+
+Or use directly:
+
+```bash
+npx @dprrwt/slides init my-talk
+```
+
+## 🚀 Quick Start
+
+```bash
+# Create a new presentation
+slides init my-talk
+
+# Enter the directory
+cd my-talk
+
+# Start live preview
+slides preview
+
+# Build static HTML
+slides build
+```
+
+## 📝 Writing Slides
+
+Separate slides with `---` on its own line:
+
+```markdown
+---
+title: My Talk
+author: Your Name
+theme: dark
+---
+
+# Hello World
+
+Welcome to my presentation.
+
+---
+
+## Agenda
+
+- First topic
+- Second topic  
+- Third topic
+
+---
+
+## Code Example
+
+\```javascript
+const greeting = "Hello, slides!";
+console.log(greeting);
+\```
+
+---
+
+> "Great quote goes here."
+
+---
+
+# Thank You! 🎉
+```
+
+### Frontmatter
+
+Set metadata at the top of your file:
+
+```yaml
+---
+title: My Presentation
+author: Your Name
+theme: dark
+---
+```
+
+### Speaker Notes
+
+Add hidden notes with HTML comments:
+
+```markdown
+## My Slide
+
+Content here.
+
+<!-- notes: Remember to mention the demo. -->
+```
+
+Press `S` during presentation to toggle notes.
+
+### Slide Directives
+
+Control individual slides with comments:
+
+```markdown
+<!-- class: custom-class -->
+<!-- background: #1a1a2e -->
+<!-- layout: center -->
+
+# Centered Slide
+```
+
+## ⌨️ Keyboard Shortcuts
+
+| Key | Action |
+|-----|--------|
+| `→` `↓` `Space` `L` `J` | Next slide |
+| `←` `↑` `H` `K` | Previous slide |
+| `Home` | First slide |
+| `End` | Last slide |
+| `S` or `N` | Toggle speaker notes |
+| `F` | Toggle fullscreen |
+| `Esc` | Close notes |
+
+Touch: swipe left/right on mobile.
+
+Click: right half → next, left half → previous.
+
+## 🎨 Themes
+
+| Theme | Description |
+|-------|-------------|
+| `dark` | Deep purple-black with violet accents (default) |
+| `light` | Clean Apple-inspired with blue accents |
+| `minimal` | Serif typography, understated elegance |
+| `neon` | Pure black with electric green highlights |
+
+Set via frontmatter (`theme: neon`) or CLI flag (`--theme neon`).
+
+## 📂 Commands
+
+### `slides init [name]`
+
+Create a new presentation with sample content.
+
+```bash
+slides init my-talk
+slides init my-talk --theme light
+```
+
+### `slides preview [file]`
+
+Live preview with hot reload. Opens browser automatically.
+
+```bash
+slides preview                  # defaults to slides.md
+slides preview deck.md -p 8080  # custom file and port
+```
+
+### `slides build [file]`
+
+Build to a single static HTML file.
+
+```bash
+slides build                    # outputs to dist/index.html
+slides build -o public          # custom output directory
+slides build deck.md --theme neon
+```
+
+### `slides export [file]`
+
+Export to PDF (uses browser print).
+
+```bash
+slides export
+```
+
+## 🚀 Deploying
+
+The build output is a **single `index.html`** file — deploy anywhere:
+
+### GitHub Pages
+
+```bash
+slides build
+cd dist
+git init
+git add .
+git commit -m "deploy slides"
+git branch -M gh-pages
+git remote add origin https://github.com/you/your-talk.git
+git push -u origin gh-pages
+```
+
+### Netlify / Vercel
+
+Point to the `dist/` folder.
+
+### Just Share
+
+Send the `dist/index.html` file directly — it's self-contained.
+
+## 📄 License
+
+MIT © [Deepankar Rawat](https://dprrwt.me)

package/demo/slides.md

@@ -0,0 +1,184 @@
+---
+title: md-slides Demo
+author: Deepankar Rawat
+theme: dark
+---
+
+# md-slides ✨
+
+Markdown → Beautiful Slides
+
+*Zero config. Developer-friendly.*
+
+---
+
+## Why md-slides?
+
+- **Write in Markdown** — your editor, your flow
+- **4 themes** — Dark, Light, Minimal, Neon
+- **Live reload** — see changes instantly
+- **Single HTML output** — deploy anywhere
+- **Speaker notes** — press `S` to toggle
+
+<!-- notes: This tool exists because making slides should be as easy as writing markdown. -->
+
+---
+
+## Getting Started
+
+```bash
+# Install globally
+npm install -g @dprrwt/slides
+
+# Create a new presentation
+slides init my-talk
+
+# Start editing and previewing
+cd my-talk
+slides preview
+```
+
+---
+
+## Slide Syntax
+
+Separate slides with `---` on its own line:
+
+```markdown
+# Title Slide
+
+Content here.
+
+---
+
+## Next Slide
+
+More content.
+
+---
+
+> A quote slide.
+```
+
+---
+
+## Code Highlighting
+
+190+ languages supported out of the box:
+
+```typescript
+interface Slide {
+  html: string;
+  notes: string;
+  layout: 'title' | 'center' | 'code' | 'quote';
+}
+
+function present(slides: Slide[]): void {
+  slides.forEach((slide, i) => {
+    render(slide, { index: i, total: slides.length });
+  });
+}
+```
+
+---
+
+## Smart Layouts
+
+Slides auto-detect their layout:
+
+| Content | Layout |
+|---------|--------|
+| Just a heading | **Center** |
+| H1 with content | **Title** |
+| Blockquote | **Quote** |
+| Code block | **Code** |
+| Everything else | **Default** |
+
+---
+
+> "The best presentations are written, not designed."
+
+<!-- notes: This is a quote slide — detected automatically from the blockquote. -->
+
+---
+
+## Themes
+
+Set via frontmatter or CLI:
+
+```yaml
+---
+theme: neon
+---
+```
+
+```bash
+slides build --theme light
+slides preview --theme minimal
+```
+
+**Built-in:** `dark` · `light` · `minimal` · `neon`
+
+---
+
+## Speaker Notes
+
+Add notes with HTML comments:
+
+```markdown
+## My Slide
+
+Content visible to audience.
+
+<!-- notes: Only you can see this. Press S. -->
+```
+
+Press **S** now to see the notes panel →
+
+<!-- notes: 👋 You found the notes! These are only visible to the presenter. Use them for talking points, reminders, or timing cues. -->
+
+---
+
+## Navigation
+
+| Key | Action |
+|-----|--------|
+| `→` `↓` `Space` | Next slide |
+| `←` `↑` | Previous slide |
+| `S` | Speaker notes |
+| `F` | Fullscreen |
+| `Home` / `End` | First / Last |
+
+**Touch:** Swipe left/right
+
+**Click:** Right half → next, Left half → prev
+
+---
+
+## Deploy Anywhere
+
+Output is a **single `index.html`** file:
+
+```bash
+# Build
+slides build
+
+# Deploy to GitHub Pages
+cd dist
+git init && git add . && git commit -m "slides"
+git push origin gh-pages
+```
+
+Or just email the HTML file. It's self-contained.
+
+---
+
+# Ship It 🚀
+
+```bash
+npm install -g @dprrwt/slides
+```
+
+**GitHub:** [dprrwt/md-slides](https://github.com/dprrwt/md-slides)
+
+**Author:** [dprrwt.me](https://dprrwt.me)