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.