rawssg/readme at main · neuxdotdev/rawssg · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
RAWSSG
Static site generator with its own .rw format – raw, minimal, no abstractions.

rawssg is a static site generator written in Rust, focused on clarity, speed, and structural transparency.
No Markdown. No HTML authoring. No abstraction layers. Just write .rw files and build.

Simplicity here is deliberate.


---

QUICK START

Install:

cargo install rawssg

Create a new site:

rawssg init my-site cd my-site

Write content:

cd content echo "# Hello World" > index.rw

Build:

rawssg build

Serve locally:

rawssg serve

Output is generated inside:

my-site/public/


---

WHY RAWSSG?

No Markdown, no HTML
rawssg uses a custom .rw syntax designed for clarity and direct structure.
No Markdown edge cases. No HTML clutter.

Zero configuration
You can write .rw files and build immediately. rawssg.toml is optional.

Fast and transparent
Built in Rust with a minimal dependency graph.
No hidden processing layers.

Modular architecture
Each responsibility is separated into independent libraries.

AGPL-3.0
Full freedom to use, study, modify, and distribute.


---

INSTALLATION

Using Cargo:

cargo install rawssg

Or download a pre-built binary from the official releases page and place it in your PATH.

---

FEATURES

Custom .rw parser
Lean and deterministic syntax.

Template inheritance
Templates stored in templates/.

Live reload
Development server reloads on file change.

Incremental builds
Only changed files are rebuilt.

Syntax highlighting
Optional support for code blocks.

Static deployment
Compatible with GitHub Pages, Netlify, Vercel, or any static hosting.


---

ARCHITECTURE

rawssg is modular by design.

uirawssg
Handles CLI interaction, prompts, logging, and user workflow.

librawssg
Core engine. Parses .rw files, builds structure, orchestrates rendering.

rawssg-templates
Default templates and layout system.

Each library is versioned independently and can evolve separately.


---

ECOSYSTEM

rawssg
Main CLI interface.

librawssg
Core parsing and build engine.

rawssg-templates
Official template collection.

uirawssg
UI and CLI layer.

---

CONTRIBUTING

Issues and pull requests are welcome.

Before contributing, read CONTRIBUTING.md.

Focus areas:

Parser refinement
Performance optimization
Template improvements
Documentation clarity


---

LICENSE

AGPL-3.0
Copyright 2025 neuxdotdev

This program is free software. You can redistribute and modify it under the terms of the GNU Affero General Public License version 3 or any later version.


---

WHY “RAW”?

rawssg rejects the complexity creep of traditional static site generators.

Instead of layering plugins, themes, and configuration systems, it introduces a clean .rw syntax and a transparent architecture.

Content first.
Structure visible.
No abstraction theater.

rawssg is an experiment in radical simplicity.