PY//NOW · Brand Guidelines
Project Identity
Official Name
- English: PY//NOW (stylized with double slash)
- Chinese: 码上Python (码上 = immediately/on the code)
- Japanese: PY//NOW マシャン Python
Taglines
Primary (English)
"Code now, master Python instantly. Learn offline, anywhere."
Secondary Options
- "Your pocket-sized cyberpunk Python terminal"
- "Learn Python without limits, without internet"
- "From print() to decorators — fully offline"
Chinese
"码上，就是马上。" "装进口袋的赛博朋克 Python 学习终端"
Japanese
"今すぐコードを書いて、Pythonをマスターしよう。" "ポケットに入るサイバーパンク風Python学習ターミナル"
Visual Identity
Color Palette
| Role | Hex | RGB | Usage |
|---|---|---|---|
| Neon Cyan | #00E5FF |
rgb(0, 229, 255) |
Primary accent, links, highlights |
| Neon Green | #00FF9C |
rgb(0, 255, 156) |
Success states, Python branding |
| Neon Magenta | #FF2D78 |
rgb(255, 45, 120) |
Warnings, errors, secondary accent |
| Neon Yellow | #F7FF00 |
rgb(247, 255, 0) |
Badges, important callouts |
| Background Dark | #0A0E17 |
rgb(10, 14, 23) |
Primary background |
| Background Medium | #111827 |
rgb(17, 24, 39) |
Secondary background, cards |
| Text Dim | #6B7280 |
rgb(107, 114, 128) |
Secondary text, labels |
| Text Bright | #F9FAFB |
rgb(249, 250, 251) |
Primary text |
Typography
UI Fonts
- Primary: System default (San Francisco on iOS, Roboto on Android)
- Code: Monospace (JetBrains Mono, Fira Code, or system monospace)
Documentation Fonts
- Headings: Bold, larger sizes with neon color accents
- Body: Regular weight, high contrast for readability
- Code blocks: Monospace with syntax highlighting
Logo Usage
Primary Logo
- Location:
docs/logo.svg - Dimensions: Width 720px (scalable SVG)
- Clear space: Minimum 20px around all sides
- Minimum size: 120px width for legibility
Logo Variations
- Full color (primary)
- Monochrome (for dark/light backgrounds)
- Icon only (for favicons, app icons)
Don'ts
- ❌ Do not stretch or distort the logo
- ❌ Do not change the colors arbitrarily
- ❌ Do not place on busy backgrounds without sufficient contrast
- ❌ Do not add effects (shadows, gradients) unless specified
Tone of Voice
Personality Traits
- Cyberpunk: Edgy, futuristic, tech-savvy
- Approachable: Friendly, encouraging, non-intimidating
- Professional: Well-documented, reliable, polished
- Gamified: Fun, rewarding, progression-focused
Writing Style
Do
- ✅ Use active voice ("Run your code" not "Code should be run")
- ✅ Be concise and direct
- ✅ Use analogies from gaming/cyberpunk culture
- ✅ Celebrate user progress ("You've unlocked Level 5!")
- ✅ Provide clear error messages with actionable fixes
Don't
- ❌ Use jargon without explanation
- ❌ Sound condescending or overly academic
- ❌ Leave users stuck without hints
- ❌ Use excessive exclamation marks!!!
- ❌ Assume prior programming knowledge
Example Phrases
Good:
- "Neural interface initialized — ready for code injection"
- "Variable snapshot captured! See what's in memory"
- "Assert shield activated — your code must pass these tests"
- "Welcome back, cyber apprentice_"
Avoid:
- "The program has been executed successfully"
- "An error occurred during runtime"
- "Please input your data"
- "Hello user"
Content Guidelines
README Structure
- Hero section with logo and tagline
- Quick visual preview (terminal mockup or screenshot)
- Target audience table
- Value proposition comparison
- Feature list with emojis
- Download/install instructions
- FAQ addressing common concerns
- Curriculum overview
- Tech stack diagram
- Roadmap showing active development
- Contributing guidelines
- License information
Release Notes Format
## v0.X.X - Codename (Optional)
### 🚀 New Features
- Feature description with benefit
### 🛠 Improvements
- Enhancement that makes existing feature better
### 🐛 Bug Fixes
- Issue that was resolved
### 📚 Content Updates
- New lessons or improvements to existing content
### 🔧 Technical Changes
- Behind-the-scenes improvements (for developers)
Social Media Posts
Twitter/X (280 chars)
🚀 PY//NOW v0.3 just dropped!
✓ Embedded CPython 3.13
✓ 30 gamified Python lessons
✓ Fully offline - no internet needed
✓ Cyberpunk neon UI
Download: [link]
#python #android #offline #coding
LinkedIn (Professional)
Excited to share PY//NOW v0.3 - an open-source Android app that teaches Python programming completely offline.
Built with Kotlin, Jetpack Compose, and Chaquopy (embedded CPython 3.13), it features:
• 30 interactive lessons from basics to decorators
• Auto-grading with assert statements
• Unique variable visualization panel
• Gamified progression system
Perfect for commuters, students in low-connectivity areas, or anyone who wants to learn Python without distractions.
Check it out: [GitHub link]
#OpenSource #Python #MobileLearning #EdTech #Android
Community Guidelines
Contributor Recognition
- List contributors in
CONTRIBUTORS.md - Mention significant PRs in release notes
- Add "Contributors" badge to README when count grows
Code of Conduct Summary
- Be respectful and inclusive
- Focus on constructive feedback
- Help newcomers learn
- Respect intellectual property
- Follow project coding standards
Support Channels
- GitHub Issues: Bug reports and feature requests
- GitHub Discussions: Questions and community chat
- Email: For security vulnerabilities (if applicable)
Merchandise & Extensions (Future)
Potential branded items:
- Stickers with neon logo
- T-shirts with terminal art
- Mousepads with Python cheat sheets
- Phone cases with cyberpunk design
Contact & Licensing
For brand usage questions:
- Open a GitHub Discussion
- Email: [project maintainer email]
License: MIT - Free to use with attribution Trademark: PY//NOW name and logo are project identity markers
Last updated: 2026-08-29 Version: 1.0