Skip to content

Latest commit

 

History

History
80 lines (58 loc) · 2.3 KB

README.md

File metadata and controls

80 lines (58 loc) · 2.3 KB

TimelyCapsule

TimelyCapsule is a web-based application that empowers users to create, seal, and send time-locked messages or media capsules. These capsules unlock at a specified date and time and can include text, images, videos, or cryptocurrency payments. The platform blends Web2 and Web3 technologies to provide a seamless and engaging experience.

Features

  • Create and schedule time-locked capsules
  • Support for text, images, videos, and cryptocurrency gifts
  • Hybrid Web2 and Web3 architecture
  • Web2-based capsule integrity and storage
  • Web3-powered subscription payments and in-app purchases
  • Guest and registered user accessibility
  • Secure and scalable infrastructure
  • Customizable capsule delivery settings

Tech Stack

TimelyCapsule is built using modern web technologies:

  • Frontend: Next.js, React, Tailwind CSS
  • Backend: Node.js, Express
  • Database: MongoDB
  • File Storage: AWS S3
  • Blockchain: Cairo, Starknet
  • Authentication: NextAuth.js
  • Payments: Web3-based transactions

Installation & Setup

To run the project locally, follow these steps:

  1. Clone the repository: bash git clone https://github.com/enbliq/timelycapsule-web.git cd timelycapsule-web

  2. Install dependencies: bash npm install

  3. Set up environment variables:

    • Create a .env.local file in the root directory.

    • Add the following line to the file:

      NEXTAUTH_SECRET=set_to_a_random_text

  4. Run the development server: bash npm run dev

    The application will be available at http://localhost:3000.

Contribution Guidelines

We welcome contributions to TimelyCapsule! Follow these steps to contribute:

  1. Fork the repository on GitHub.
  2. Clone your forked repository: bash git clone https://github.com/your-username/timelycapsule-web.git
  3. Create a new branch for your feature or bug fix: bash git checkout -b feature-name
  4. Make your changes and commit: bash git add . git commit -m "Describe your changes"
  5. Push to your fork: bash git push origin feature-name
  6. Submit a Pull Request (PR) to the main repository.

License

TimelyCapsule is open-source and licensed under the MIT License.

Contact

For any questions, feel free to reach out via GitHub Issues or visit the repository.