aboutsummaryrefslogtreecommitdiffstatshomepage
path: root/packages/docs/README.md
diff options
context:
space:
mode:
authorcopilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>2026-01-21 13:01:23 +0000
committercopilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>2026-01-21 13:01:23 +0000
commit6db4a3b1807d0d305538a6b83ba9cad047f542d0 (patch)
treefe1344c43cfdb5bdedf4850dd25046a6914e82bd /packages/docs/README.md
parent10c560f822d1ef4a9b9dfb550638127b7b3a71de (diff)
downloadDropOut-6db4a3b1807d0d305538a6b83ba9cad047f542d0.tar.gz
DropOut-6db4a3b1807d0d305538a6b83ba9cad047f542d0.zip
docs: add comprehensive documentation for DropOut launcher
Co-authored-by: HsiangNianian <44714368+HsiangNianian@users.noreply.github.com>
Diffstat (limited to 'packages/docs/README.md')
-rw-r--r--packages/docs/README.md159
1 files changed, 151 insertions, 8 deletions
diff --git a/packages/docs/README.md b/packages/docs/README.md
index 2b4c09a..055e479 100644
--- a/packages/docs/README.md
+++ b/packages/docs/README.md
@@ -1,14 +1,157 @@
-# docs
+# DropOut Documentation
-This is a React Router application generated with
-[Create Fumadocs](https://github.com/fuma-nama/fumadocs).
+This is the official documentation site for DropOut Minecraft Launcher, built with [Fumadocs](https://fumadocs.dev) and React Router v7.
-Run development server:
+## Overview
+
+The documentation covers:
+- **Getting Started**: Installation and first-time setup
+- **Features**: Detailed guides for all launcher features
+- **Architecture**: Technical design and implementation details
+- **Development**: Building and contributing to DropOut
+- **Troubleshooting**: Common issues and solutions
+
+## Development
+
+### Prerequisites
+
+- Node.js 22+
+- pnpm 9+
+
+### Setup
+
+Install dependencies:
+
+```bash
+pnpm install
+```
+
+### Run Development Server
```bash
-npm run dev
-# or
pnpm dev
-# or
-yarn dev
```
+
+This starts the development server at `http://localhost:5173` with hot reload enabled.
+
+### Build for Production
+
+```bash
+pnpm build
+```
+
+The production build will be output to the `build/` directory.
+
+### Type Checking
+
+```bash
+pnpm types:check
+```
+
+### Linting and Formatting
+
+```bash
+# Check code
+pnpm lint
+
+# Format code
+pnpm format
+```
+
+## Project Structure
+
+```
+packages/docs/
+├── content/
+│ └── docs/ # Documentation content (MDX)
+│ ├── index.mdx # Home page
+│ ├── getting-started.mdx
+│ ├── architecture.mdx
+│ ├── development.mdx
+│ ├── troubleshooting.mdx
+│ └── features/ # Feature-specific docs
+├── app/ # React Router app
+├── public/ # Static assets
+├── source.config.ts # Fumadocs configuration
+└── react-router.config.ts # React Router configuration
+```
+
+## Writing Documentation
+
+### MDX Format
+
+All documentation is written in MDX (Markdown with JSX):
+
+```mdx
+---
+title: Page Title
+description: Page description for SEO
+---
+
+# Page Title
+
+Content goes here...
+
+<Cards>
+ <Card title="Link Title" href="/path" />
+</Cards>
+```
+
+### Available Components
+
+Fumadocs provides several components:
+
+- `<Card>` - Link cards
+- `<Cards>` - Card container
+- `<Callout>` - Info/warning boxes
+- `<Tabs>` - Tabbed content
+- `<Steps>` - Numbered steps
+- Code blocks with syntax highlighting
+
+### Adding New Pages
+
+1. Create new `.mdx` file in `content/docs/`
+2. Add frontmatter with title and description
+3. Write content using MDX
+4. Update `meta.json` to include the page
+5. Test locally with `pnpm dev`
+
+### Organizing Content
+
+Use `meta.json` files to organize navigation:
+
+```json
+{
+ "title": "Section Title",
+ "pages": [
+ "page1",
+ "page2",
+ {
+ "title": "Subsection",
+ "pages": ["sub1", "sub2"]
+ }
+ ]
+}
+```
+
+## Deployment
+
+The documentation is automatically deployed when changes are merged to the main branch.
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Test locally
+5. Submit a pull request
+
+## Links
+
+- [DropOut Repository](https://github.com/HydroRoll-Team/DropOut)
+- [Fumadocs](https://fumadocs.dev)
+- [React Router](https://reactrouter.com)
+
+## License
+
+MIT License - see the main repository for details.