Skip to content

Commit cc69ec2

Browse files
committed
Add new examples and update workspace version
Added new example projects: rate-limit-demo, graphql-api, microservices, and middleware-chain. Updated workspace version to 0.1.5 and internal crate dependencies to 0.1.4 in Cargo.toml. Added promotional and social media documentation files, and updated the main README with new content.
1 parent 39da866 commit cc69ec2

18 files changed

Lines changed: 3423 additions & 51 deletions

File tree

Cargo.lock

Lines changed: 794 additions & 33 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

Cargo.toml

Lines changed: 13 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -20,11 +20,15 @@ members = [
2020
"examples/mcp-server",
2121
"examples/websocket",
2222
"examples/templates",
23+
"examples/rate-limit-demo",
24+
"examples/graphql-api",
25+
"examples/microservices",
26+
"examples/middleware-chain",
2327
"benches/toon_bench",
2428
]
2529

2630
[workspace.package]
27-
version = "0.1.6"
31+
version = "0.1.5"
2832
edition = "2021"
2933
authors = ["RustAPI Contributors"]
3034
license = "MIT OR Apache-2.0"
@@ -102,12 +106,12 @@ indicatif = "0.17"
102106
console = "0.15"
103107

104108
# Internal crates
105-
rustapi-core = { path = "crates/rustapi-core", version = "0.1.6", default-features = false }
106-
rustapi-macros = { path = "crates/rustapi-macros", version = "0.1.6" }
107-
rustapi-validate = { path = "crates/rustapi-validate", version = "0.1.6" }
108-
rustapi-openapi = { path = "crates/rustapi-openapi", version = "0.1.6", default-features = false }
109-
rustapi-extras = { path = "crates/rustapi-extras", version = "0.1.6" }
110-
rustapi-toon = { path = "crates/rustapi-toon", version = "0.1.6" }
111-
rustapi-ws = { path = "crates/rustapi-ws", version = "0.1.6" }
112-
rustapi-view = { path = "crates/rustapi-view", version = "0.1.6" }
109+
rustapi-core = { path = "crates/rustapi-core", version = "0.1.4", default-features = false }
110+
rustapi-macros = { path = "crates/rustapi-macros", version = "0.1.4" }
111+
rustapi-validate = { path = "crates/rustapi-validate", version = "0.1.4" }
112+
rustapi-openapi = { path = "crates/rustapi-openapi", version = "0.1.4", default-features = false }
113+
rustapi-extras = { path = "crates/rustapi-extras", version = "0.1.4" }
114+
rustapi-toon = { path = "crates/rustapi-toon", version = "0.1.4" }
115+
rustapi-ws = { path = "crates/rustapi-ws", version = "0.1.4" }
116+
rustapi-view = { path = "crates/rustapi-view", version = "0.1.4" }
113117

PROMOTION.md

Lines changed: 323 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,323 @@
1+
# 🌟 RustAPI Growth Strategy — Road to 93+ Stars
2+
3+
**Current Stars**: 20 ⭐
4+
**Target**: 93 ⭐
5+
**Gap**: 73 stars
6+
**Timeline**: 3-6 months
7+
8+
---
9+
10+
## 📊 Growth Phases
11+
12+
### Phase 1: Foundation (Month 1) — Target: 35 stars (+15)
13+
14+
**Focus**: Quality & Visibility
15+
16+
#### Actions:
17+
- [x] ✅ Enhanced README with benchmarks
18+
- [x] ✅ Added 4+ new examples (GraphQL, Microservices, Rate Limiting, Middleware)
19+
- [x] ✅ Comparison table with other frameworks
20+
- [x] ✅ Star History badge
21+
- [ ] 🔄 Create project logo variants (dark/light mode)
22+
- [ ] 🔄 Record 2-minute demo video
23+
- [ ] 🔄 Write launch blog post on Dev.to & Medium
24+
25+
#### Promotion Channels:
26+
- **Reddit**:
27+
- r/rust — Monthly "What are you working on?" thread
28+
- r/programming — "Show HN" style post
29+
- r/webdev — Framework comparison post
30+
- **Twitter/X**:
31+
- Daily #RustLang tweets showcasing features
32+
- Tag @rustlang, @tokio_rs
33+
- **Hacker News**:
34+
- "Show HN: RustAPI – FastAPI-like ergonomics in Rust"
35+
36+
---
37+
38+
### Phase 2: Community Building (Month 2-3) — Target: 60 stars (+25)
39+
40+
**Focus**: Engagement & Content
41+
42+
#### Content Strategy:
43+
1. **Blog Series** (Dev.to, Medium, own blog):
44+
- "Building a REST API in 5 Lines with Rust"
45+
- "Why RustAPI Uses the Facade Pattern"
46+
- "TOON Format: 50% Token Savings for LLMs"
47+
- "Microservices Architecture with RustAPI"
48+
49+
2. **Video Content** (YouTube):
50+
- Tutorial series (10-15 min each):
51+
- "Quick Start with RustAPI"
52+
- "Building a CRUD API"
53+
- "JWT Authentication"
54+
- "GraphQL Integration"
55+
- Live coding sessions on Twitch/YouTube
56+
57+
3. **Comparison Articles**:
58+
- "RustAPI vs Axum: Which Should You Choose?"
59+
- "Migrating from FastAPI to RustAPI"
60+
- "Performance Benchmarks: Rust Web Frameworks 2026"
61+
62+
#### Community Initiatives:
63+
- [ ] Launch Discord/Telegram community
64+
- [ ] Weekly office hours (Q&A sessions)
65+
- [ ] Contributor recognition program
66+
- [ ] "Good First Issue" labels for new contributors
67+
- [ ] Monthly community call
68+
69+
#### Social Proof:
70+
- [ ] Get testimonials from early adopters
71+
- [ ] Case study: "How Company X achieved 10x performance with RustAPI"
72+
- [ ] Add "Built with RustAPI" showcase page
73+
74+
---
75+
76+
### Phase 3: Viral Growth (Month 4-6) — Target: 93+ stars (+33)
77+
78+
**Focus**: Reach & Recognition
79+
80+
#### Major Launches:
81+
1. **Product Hunt Launch**:
82+
- Prepare assets (logo, screenshots, demo video)
83+
- Schedule for Tuesday-Thursday (best days)
84+
- Coordinate with community for upvotes
85+
- Target: Product of the Day
86+
87+
2. **Conference Talks**:
88+
- Submit to RustConf, EuroRust, FOSDEM
89+
- Local Rust meetups (virtual/in-person)
90+
- Lightning talks at general tech conferences
91+
92+
3. **Open Source Awards**:
93+
- GitHub Stars program
94+
- Rust Foundation grants
95+
- Google Summer of Code mentor org
96+
97+
#### Partnerships:
98+
- [ ] Integration with popular Rust crates (sqlx, diesel, sea-orm)
99+
- [ ] Collaborate with Rust influencers (Jon Gjengset, fasterthanlime)
100+
- [ ] Cross-promotion with complementary projects
101+
102+
#### Advanced Content:
103+
- [ ] Technical deep-dive on routing performance
104+
- [ ] White paper: "Facade Architecture in Web Frameworks"
105+
- [ ] Podcast appearances (Rustacean Station, etc.)
106+
107+
---
108+
109+
## 🎯 Weekly Action Plan
110+
111+
### Week 1-2:
112+
- [ ] Post on r/rust (showcase new examples)
113+
- [ ] Publish 1 blog post on Dev.to
114+
- [ ] Tweet 3x daily with code snippets
115+
- [ ] Respond to all GitHub issues/PRs within 24h
116+
117+
### Week 3-4:
118+
- [ ] Submit to Hacker News
119+
- [ ] Record first YouTube tutorial
120+
- [ ] Reach out to 5 Rust YouTubers for collabs
121+
- [ ] Add 2 more examples (Redis cache, SSE)
122+
123+
### Month 2:
124+
- [ ] Launch Product Hunt campaign
125+
- [ ] Publish comparison article (RustAPI vs Axum)
126+
- [ ] Start weekly livestream series
127+
- [ ] Create RustAPI Twitter bot (shares tips daily)
128+
129+
### Month 3:
130+
- [ ] Conference talk submission deadline
131+
- [ ] Publish "Year in Review" blog post
132+
- [ ] Launch contributor spotlight series
133+
- [ ] Create interactive playground (try.rustapi.dev)
134+
135+
---
136+
137+
## 📈 Metrics to Track
138+
139+
### GitHub Metrics:
140+
- ⭐ Stars (target: 93)
141+
- 👁️ Watchers
142+
- 🍴 Forks
143+
- 🐛 Issues opened/closed
144+
- 🔄 PRs merged
145+
- 👥 Contributors
146+
147+
### Engagement Metrics:
148+
- 📊 crates.io downloads
149+
- 📖 docs.rs page views
150+
- 💬 Discord/Telegram members
151+
- 🐦 Twitter followers
152+
- 📹 YouTube subscribers
153+
154+
### Quality Metrics:
155+
- ✅ Test coverage
156+
- 📝 Documentation completeness
157+
- 🚀 Benchmark improvements
158+
- 🐞 Bug reports vs fixes
159+
160+
---
161+
162+
## 🎨 Content Templates
163+
164+
### Reddit Post Template:
165+
```markdown
166+
[Show r/rust] RustAPI – FastAPI-like ergonomics for Rust web APIs
167+
168+
Hey Rustaceans! I've been working on RustAPI, a web framework that brings
169+
FastAPI's developer experience to Rust.
170+
171+
Key features:
172+
- 5-line REST APIs with auto-generated OpenAPI docs
173+
- Facade pattern for long-term stability
174+
- Built-in JWT, CORS, WebSocket, and rate limiting
175+
- TOON format for 50% token savings in LLM APIs
176+
177+
Just released 4 new examples: GraphQL, Microservices, Rate Limiting,
178+
and Middleware Chain.
179+
180+
Check it out: https://github.com/Tuntii/RustAPI
181+
182+
Would love your feedback! 🦀
183+
```
184+
185+
### Twitter Thread Template:
186+
```
187+
1/ 🚀 Ever wanted FastAPI's simplicity in Rust?
188+
189+
Meet RustAPI – a web framework that lets you build REST APIs in 5 lines:
190+
191+
[code snippet image]
192+
193+
2/ Why RustAPI?
194+
195+
✅ Zero-config routing with auto()
196+
✅ Auto-generated OpenAPI docs
197+
✅ Built-in JWT, CORS, WebSocket
198+
✅ 50% token savings for LLM APIs (TOON format)
199+
200+
3/ Unlike other frameworks, RustAPI uses the Facade Pattern.
201+
202+
Internal upgrades (hyper, tokio) don't break your code.
203+
204+
[architecture diagram]
205+
206+
4/ New examples just dropped:
207+
208+
🔐 Middleware Chain
209+
🌐 Microservices
210+
🔍 GraphQL Integration
211+
⏱️ Rate Limiting
212+
213+
Explore: https://github.com/Tuntii/RustAPI/tree/main/examples
214+
215+
5/ Star ⭐ the repo if you're interested!
216+
217+
Building something with RustAPI? Tag me, I'd love to see it! 🦀
218+
219+
#RustLang #WebDev #OpenSource
220+
```
221+
222+
---
223+
224+
## 🤝 Collaboration Opportunities
225+
226+
### Influencers to Reach Out:
227+
1. **Jon Gjengset** (@jonhoo) — Rust educator
228+
2. **fasterthanlime** (@fasterthanlime) — Rust blog
229+
3. **Luca Palmieri** (@algo_luca) — Zero to Production author
230+
4. **Tim McNamara** (@timClicks) — Rust in Action author
231+
5. **Brooks Builds** (@brooks_patton) — Rust YouTuber
232+
233+
### Email Template:
234+
```
235+
Subject: Collaboration Opportunity: RustAPI
236+
237+
Hi [Name],
238+
239+
I'm Tunahan, creator of RustAPI – a Rust web framework focused on
240+
developer ergonomics and AI-first features.
241+
242+
I've been following your work on [specific content], and I think
243+
your audience would benefit from learning about RustAPI's approach
244+
to [specific feature].
245+
246+
Would you be interested in:
247+
- A guest blog post on your site?
248+
- A livestream collaboration?
249+
- Reviewing RustAPI for feedback?
250+
251+
No pressure at all! Just thought there might be synergy.
252+
253+
Best,
254+
Tunahan
255+
256+
GitHub: https://github.com/Tuntii/RustAPI
257+
Docs: https://docs.rs/rustapi-rs
258+
```
259+
260+
---
261+
262+
## 🏆 Success Milestones
263+
264+
- [ ] **25 stars** — First milestone celebration tweet
265+
- [ ] **50 stars** — Release v0.2.0 with new features
266+
- [ ] **75 stars** — Launch showcase page with user projects
267+
- [ ] **93 stars** — 🎉 GOAL ACHIEVED! Host virtual celebration
268+
- [ ] **100 stars** — Create "100 Stars" thank-you video
269+
270+
---
271+
272+
## 💡 Creative Growth Hacks
273+
274+
1. **"Star for Tutorial"**: Create exclusive advanced tutorial for star contributors
275+
2. **Weekly Feature Poll**: Let community vote on next feature
276+
3. **Contributor Shoutouts**: Featured developer each week
277+
4. **Benchmark Challenge**: Beat our benchmarks, get featured
278+
5. **Example Contest**: Best community example wins swag
279+
6. **"First 100"**: Special recognition for first 100 stargazers
280+
281+
---
282+
283+
## 📞 Where to Promote
284+
285+
### Primary Channels (Weekly):
286+
- ✅ Reddit r/rust
287+
- ✅ Twitter/X #RustLang
288+
- ✅ Dev.to #rust
289+
- ✅ Hacker News
290+
- ✅ Lobsters (https://lobste.rs)
291+
292+
### Secondary Channels (Bi-weekly):
293+
- ✅ Reddit r/programming, r/webdev
294+
- ✅ LinkedIn #rust #webdevelopment
295+
- ✅ Medium publications (Better Programming, etc.)
296+
- ✅ This Week in Rust newsletter submissions
297+
298+
### Community Forums:
299+
- ✅ Rust Users Forum
300+
- ✅ Rust Subreddit Discord
301+
- ✅ Tokio Discord
302+
- ✅ Actix Discord
303+
304+
---
305+
306+
## 🎯 Call to Action (for Users)
307+
308+
**Help RustAPI reach 93+ stars!**
309+
310+
You can help by:
311+
1.**Star the repo** — Takes 2 seconds, means the world
312+
2. 🐦 **Share on Twitter** — Tag @Tuntii
313+
3. 📝 **Write a blog post** — We'll feature it
314+
4. 🐛 **Report bugs** — Help us improve
315+
5. 💬 **Join discussions** — Share your ideas
316+
6. 🤝 **Contribute** — PRs welcome!
317+
318+
Together, let's make Rust web development better! 🦀
319+
320+
---
321+
322+
**Last Updated**: January 6, 2026
323+
**Next Review**: January 13, 2026

0 commit comments

Comments
 (0)