Welcome to Projex Documentation¶
Why Projex?¶
Skip the boring setup and jump straight into coding! Projex generates complete, production-ready project structures with best practices baked in.
β‘ Quick Example¶
# Install
pip install projex
# Create your project
projex create my-api --template fastapi --db postgresql --auth jwt
# Start coding!
cd my-api
source venv/bin/activate
uvicorn app.main:app --reload
That's it! You now have a production-ready FastAPI project with PostgreSQL and JWT authentication! π
β¨ Key Features¶
-
:rocket:{ .lg .middle } 8 Framework Templates
FastAPI, Django, Flask, Bottle, Pyramid, Tornado, Sanic, CherryPy
-
:material-database:{ .lg .middle } 5 Database Options
PostgreSQL, MySQL, MongoDB, SQLite, Redis
-
:material-shield-lock:{ .lg .middle } 4 Auth Methods
JWT, OAuth2, API Key, Basic Authentication
-
:material-code-braces:{ .lg .middle } Smart Scaffolding
Generate models, endpoints, services with one command
-
:material-docker:{ .lg .middle } Docker Ready
Complete Docker and docker-compose setup included
-
:material-test-tube:{ .lg .middle } Testing Built-in
pytest configuration with fixtures and examples
-
:octicons-workflow-24:{ .lg .middle } CI/CD Pipelines
GitHub Actions, GitLab CI, CircleCI configs
-
:material-file-document:{ .lg .middle } Documentation Tools
MkDocs and Sphinx setup included
π Quick Start¶
Get started in 3 easy steps:
1. Install Projex¶
2. Create Your Project¶
3. Start Development¶
Visit http://localhost:8000/docs for interactive API documentation! π
π What Gets Generated?¶
Every project includes:
β
Production-ready structure - Best practices baked in
β
Docker support - Dockerfile and docker-compose
β
Testing setup - pytest with examples
β
Environment config - .env file management
β
Database integration - ORM/ODM configured
β
Authentication - Ready to use auth system
β
API documentation - Auto-generated docs
β
Git initialization - Ready for version control
π― Use Cases¶
Microservices Architecture¶
projex create user-service --template fastapi
projex create order-service --template fastapi
projex create payment-service --template fastapi
REST API Development¶
projex create my-api --template fastapi --db postgresql --auth jwt
cd my-api
projex add cicd --provider github
Full-Stack Application¶
Full-stack setup βπ Next Steps¶
-
:material-clock-fast:{ .lg } Quick Start Guide
Learn the basics in 5 minutes
-
:material-view-grid:{ .lg } Framework Templates
Explore all 8 framework options
-
:material-hammer-wrench:{ .lg } CLI Reference
Complete command documentation
-
:material-school:{ .lg } Advanced Topics
Customization and best practices
π€ Community & Support¶
- GitHub: Star the repository β
- Issues: Report bugs π
- Discussions: Ask questions π¬
- Contributing: Contribution guidelines π€
πΊοΈ Roadmap¶
Check out our Changelog for recent updates and the GitHub Projects for upcoming features.
Recently Added β ¶
- 8 framework templates
- Smart scaffolding system
- CI/CD pipeline generation
- Environment management
- Enhanced testing tools
Coming Soon π¶
- Frontend templates (React, Vue)
- GraphQL support
- Kubernetes configurations
- Plugin system