My very first project as a beginner! 🎉
StoryCloak is a simple Flask web app that lets you create, store, and manage your personal stories and notes securely.
You can try the app here: StoryCloak on Render
StoryCloak is built with Flask as the backend and uses Bootstrap for styling.
It supports user authentication, note management, and a clean UI for a smooth writing experience.
The aim was to learn the basics of backend development, databases, and authentication — and I had fun building it!
-
📝 Create & Manage Stories – Add, edit, and delete your personal stories.
-
🔐 User Authentication – Sign up, log in, and manage your account.
-
🎨 Clean UI – Responsive and mobile-friendly design using Bootstrap.
-
📂 Database Support – Store data securely using SQLAlchemy.
- Backend: Flask, SQLAlchemy ORM
- Database: PostgreSQL (via Render)
- Frontend: HTML, CSS, Bootstrap
- Authentication: Flask-Login, Bcrypt
- Others: WTForms, Flask-WTF, Flask-Mail, flask-migrate
- Deployment Render (Free Trail)
Follow these steps to run StoryCloak on your local machine:
-
Clone the repository
git clone https://github.com/your-username/storycloak.git cd storycloak -
Create a virtual environment
python -m venv venv
-
Activate the virtual environment
-
Windows:
venv\Scripts\activate
-
Mac/Linux:
source venv/bin/activate
-
-
Install dependencies
pip install -r requirements.txt
-
Set environment variables
export FLASK_APP=run.py export FLASK_ENV=development
(On Windows use
setinstead ofexport) -
Set up the database
Run the following commands to set up and apply migrations:
flask db init
flask db migrate -m "Initial migration"
flask db upgrade-
Run the application
flask run
-
Visit in browser Open http://localhost:5000 🚀
Since this is my first project, I’d love feedback! Feel free to fork the repo, make changes, and submit a pull request.
This project is licensed under the MIT License – you’re free to use, modify, and distribute it.
⭐ If you like this project, please give it a star! ⭐