The Official Pixel Stories and PS Maker Website

This repository contains all the information and documentation for Pixel Stories and PS Maker.

🐛 PS Maker Bugs & Feature Requests

Found a bug in PS Maker or have a feature idea? We'd love to hear from you!

Create a GitHub Issue to report bugs or suggest new features for PS Maker.

Please include as much detail as possible:

• For bugs: steps to reproduce, expected vs actual behavior, screenshots if applicable
• For features: describe the use case and how it would improve your workflow

---

Contributing to the Documentation

We welcome contributions to help improve our docs! This site is built with Astro and Starlight.

Prerequisites

• Node.js (v18 or higher recommended)
• npm or your preferred package manager

Getting Started

1. Clone the repository

   git clone https://github.com/PixelStoriesOrg/pixel-stories.git
   cd pixel-stories

2. Install dependencies

   npm install

3. Start the development server

   npm run dev

   The site will be available at http://localhost:4321

Project Structure

src/
├── content/
│   ├── docs/          # Documentation pages (MDX/MD files)
│   │   ├── event-system/
│   │   ├── game-assets/
│   │   ├── guides/
│   │   └── map-editor/
│   └── blog/          # Blog posts (Markdown files)
├── components/        # Astro & Svelte components
├── assets/            # Images and other static assets
│   └── docs-images/   # Screenshots for documentation
└── overrides/         # Starlight component overrides

Writing Documentation

• Documentation lives in src/content/docs/
• Files can be .md (Markdown) or .mdx (MDX with component support)
• Each doc file needs frontmatter with at least a title:

  ---
  title: "Your Page Title"
  description: "Optional description for SEO"
  ---

• Images should be placed in src/assets/docs-images/ and referenced with relative paths

Writing Blog Posts

• Blog posts live in src/content/blog/
• Use Markdown format with appropriate frontmatter
• See existing posts for examples of the expected structure

Available Commands

Command	Description
npm run dev	Start local dev server
npm run build	Build the production site
npm run preview	Preview the production build locally

Submitting Changes

1. Fork the repository
2. Create a new branch for your changes
3. Make your edits
4. Test locally with npm run dev
5. Submit a pull request

Thank you for helping improve the Pixel Stories documentation! 💜