A Full-Stack Blog Application built with FastAPI and React.
- ✅ Sign-up & Sign-in
- ✅ Customizeable User Profile
- ✅ Create and manage posts
- ✅ Read, share and interact with posts
- ✅ API Documentation
- ✅ PostgreSQL Database
- ✅ Alembic Migrations and seed data
- ✅ Docker and Docker Compose
- ✅ CI/CD with GitHub Actions (coming soon)
- ✅ Monitoring and Logging (coming soon)
- ✅ Automated Tests (coming soon)
To know more about the project structure, check the structure.md file.
- Clone the repository
git clone https://github.com/wesleybertipaglia/blog-sphere.git- Initialize and Activate the virtual environment
Make init
source venv/bin/activate- Install the dependencies and init the alembic
Make setup- Run the application
Make run🚀 Open your browser and go to http://localhost:8000 to see the api in action.
All commands are run from the root of the project, from a terminal:
| Command | Action |
|---|---|
Make init |
Initialize the virtual enviroment |
source venv/bin/activate |
Activate the virtual enviroment |
Make setup |
Install dependencies and init the alembic |
Make freeze |
Update the dependencies |
Make run |
Starts the application |
Make alembic-revision |
Make an alembic revision |
Make alembic-upgrade |
Make an alembic upgrade |
To know more about the commands, check the commands.md file.
The API has the following endpoints:
/auth: Sign-up and Sign-in/profile: Read, Update, Delete/users: Read/posts: Create, Read, Update, Delete
To know more about the endpoints, check the endpoints.md file, or access the API documentation in the following URL: localhost:8000/docs
To know more about the tech stack, check the stack.md file.
The following checklist can be used to track the project progress:
- Authentication
- Authorization
- Documentation
- Tests
- Docker
- CI/CD
- Deploy
- Monitoring
This repository is licensed under the [MIT]. See the LICENSE file for details.