Loading repository data…
thapelomagqazana / repository
A minimal FastAPI, React, MongoDB (FARM) boilerplate with JWT authentication and user CRUD. Secure, scalable, and extendable for modern web applications.
A transparent discovery signal based on current public GitHub metadata.
This score does not audit code, security, maintainers, documentation quality, or suitability. Verify the repository and its current documentation before adoption.
A minimal FARM (FastAPI, React, MongoDB) boilerplate with JWT authentication and user CRUD operations.
Secure, scalable, and extendable for modern web applications.
farm-skeleton/
│── backend/ # FastAPI Backend
│ ├── app/
│ │ ├── models.py # User models and validation
│ │ ├── database.py # MongoDB connection setup
│ │ ├── main.py # FastAPI entry point
│ │ ├── routes/
│ │ │ ├── users.py # User CRUD operations
│ │ │ ├── auth.py # Authentication routes
│ │ ├── security.py # Password hashing & JWT handling
│ ├── .env # Environment variables
│ ├── requirements.txt # Dependencies
│ ├── run.sh # Startup script
│ ├── README.md # Backend documentation
│
│── frontend/ # React + Vite Frontend
│ ├── src/
│ │ ├── components/ # UI Components
│ │ ├── pages/
│ │ │ ├── Home.tsx # Home page
│ │ │ ├── Signin.tsx # Sign-in page
│ │ │ ├── Register.tsx # Register page
│ │ │ ├── Profile.tsx # User profile (protected)
│ │ ├── utils/
│ │ │ ├── api.ts # API request handler
│ │ │ ├── auth.ts # JWT auth utilities
│ ├── .env.local # Environment variables
│ ├── tsconfig.json # TypeScript configuration
│ ├── package.json # Frontend dependencies
│ ├── README.md # Frontend documentation
│
│── README.md # Overall project documentation
1️⃣ Navigate to the backend folder
cd backend
2️⃣ Create a virtual environment
python3 -m venv venv
source venv/bin/activate # On Mac/Linux
venv\Scripts\activate # On Windows
3️⃣ Install dependencies
pip install -r requirements.txt
4️⃣ Set up environment variables
Create a .env file:
MONGO_URI=mongodb://localhost:27017/farm_skeleton
SECRET_KEY=your_jwt_secret_key
ALGORITHM=HS256
ACCESS_TOKEN_EXPIRE_MINUTES=30
TEST_ENV=true
FRONTEND_ORIGIN=http://localhost:3000
Selected from shared topics, language and repository description—not editorial ratings.
nbolok-code /
A minimal, single-file FastAPI backend with complete CRUD operations. Perfect for prototypes, demos, and learning.
52/100 health5️⃣ Run the server
chmod +x run.sh
./run.sh
or manually:
uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload
1️⃣ Navigate to the frontend folder
cd frontend
2️⃣ Install dependencies
npm install
3️⃣ Set up environment variables
Create a .env file:
VITE_PORT=3000
VITE_API_URL=http://localhost:8000
4️⃣ Run the frontend
npm run dev
| Operation | API Route | Method |
|---|---|---|
| Create User | /api/users | POST |
| List Users | /api/users | GET |
| Get User | /api/users/{id} | GET |
| Update User | /api/users/{id} | PUT |
| Delete User | /api/users/{id} | DELETE |
| Operation | API Route | Method |
|---|---|---|
| Sign-in | /auth/signin | POST |
| Sign-out | /auth/signout | POST |
Sign in:
curl -X POST "http://localhost:8000/auth/signin" -H "Content-Type: application/json" -d '{"email": "test@example.com", "password": "yourpassword"}'
POST, GET, PUT, DELETE requests🚀 Enhancements & Features to Add
Pull requests are welcome! Feel free to open an issue to suggest improvements.
This project is open-source under the MIT License.
🚀 Happy Coding! 🚀